outreach

List the approval queue

One list across every channel: LinkedIn steps and emails, each waiting on a person, waiting on its channel, or settled. Newest first by default, the order the Tasks page opens in; order by created_at or contact_label, which sorts by the contact as the Tasks page's Contact column shows them (a LinkedIn profile address by its slug, letters in any case together, a task about nobody as the empty name). Pending by default; pass status (repeatable) for the other tabs, and narrow by channel, task kind, sender, sequence, how it ended (outcome; the failed steps are status=cancelled&outcome=failed), why it waits for a person (ask_reason), words in the contact or the subject (search) or how long it has been waiting. Our own LinkedIn reads of the account (the inbox, sent invitations, new connections, one conversation) are left out unless background_checks asks for them. GET /outreach-tasks/length/ counts the same filters. Every name the row shows (the sequence, the step, the sender, who decided) is resolved here, and every approved, finished or cancelled task says where its work stands (progress: queued with its expected start, running, held by the sending window, sent, failed and whether it can be retried).

get/outreach-tasks/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/outreach-tasks/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

ask_reasonAskReason[] nullable

Only tasks held for a person for one of these reasons (repeatable): the Tasks page's Held because. Omit for every reason.

background_checks'hide' | 'include' | 'only'

Whether a reading of Activity lists our own LinkedIn reads of the sender's account.

The reads (BACKGROUND_CHECK_KINDS: the inbox, the sent invitations, the newest connections, one conversation) act on nobody, so every Activity page hides them unless a person turns them on (Utku, 2026-10-19: behind a filter, so a customer worried about their LinkedIn account can see every time we touched it). HIDE leaves them out, INCLUDE lists them with everything else, ONLY lists them alone.

channelTaskChannel[] nullable

Only these channels; omit for every channel.

enrolment_idstring[] nullable

Only the tasks of these contacts, by their enrolment in a sequence; omit for everyone.

kindstring[] nullable

Only these kinds: a LinkedIn action slug (profile_view, connection_request, …) or email. Omit for every kind.

outcomestring[] nullable

Only tasks that ended with one of these words (repeatable): failed, skipped, stopped, succeeded and the like. The tasks that failed are status=cancelled with outcome=failed. Omit for however they ended.

searchstring nullable

Words that must each appear in the contact's name, address or LinkedIn profile, or in the subject.

sender_profile_idstring[] nullable

Only these senders; omit for everyone.

sequence_idstring[] nullable

Only these sequences; omit for all of them.

statusTaskStatus[]

Only these statuses; repeat the parameter for several. Defaults to pending.

waiting_since_beforestring date-time nullable

Only tasks that entered the queue before this instant, which is 'waiting longer than'. Read off when the task was created, not when its channel would run it. Omit for however long they have been here.

limitinteger

The number of items to return.

order_by'created_at' | 'contact_label'
order_direction'asc' | 'desc'
cursorstring nullable

Set the cursor to the next or previous page. You can get the cursor from the previous page's response.

Response

Successful Response

next_page_cursorstring nullable

The cursor to the next page. If there are no more pages, this is None.

previous_page_cursorstring nullable

The cursor to the previous page. If there are no previous pages, this is None.

Changes

No recorded changes to this operation across all 2 revisions of this API.