Skip to main content
Sent when we make new tasks for an account: things the person behind it has to give or do. The most common cause is you asking for a new capability. Use it to send the person their onboarding link at the right moment. Delivered to endpoints with event_source set to connect or all. See Connect events.

​
Event fields

​
string
The event’s unique identifier, prefixed evt_. Use it to deduplicate deliveries.
​
string
Always account.tasks_requested.
​
string
When the event occurred, in UTC.
​
string
The account the tasks are for.
​
string
The account’s id, repeated at the top level. This is how a platform tells which of its accounts the event concerns.
​
string
The account’s id. Matches organization_id.
​
string[]
The ids of the tasks made in this batch.

​
When it fires

Once for each batch of new tasks. A retry of the same batch is not sent twice.

​
What to do on receipt

Send the person their onboarding link, or tell them in your app that there is something new to do. Read the account’s requirements for exactly what it owes. See Requirements.