Skip to content

Create a task about a person

POST
/audience/management/v1/individuals/{id}/tasks
curl --request POST \
--url https://api.ebitex.io/audience/management/v1/individuals/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "title": "example", "note": "example", "assigneeExternalUserId": "example", "assigneeLabel": "example", "dueAtUtc": "2026-04-15T12:00:00Z" }'

Adds a task to the review queue. title is required (200 characters at most); note, assigneeExternalUserId, assigneeLabel and dueAtUtc are optional. A person can have at most 200 open tasks.

Key: an Audience management key with audience.management.write (write also needs read; erase needs both).

id
required
string format: uuid
Media typeapplication/json
object
title
null | string
note
null | string
assigneeExternalUserId
null | string
assigneeLabel
null | string
dueAtUtc
null | string format: date-time
Examplegenerated
{
"title": "example",
"note": "example",
"assigneeExternalUserId": "example",
"assigneeLabel": "example",
"dueAtUtc": "2026-04-15T12:00:00Z"
}

The review item, as listed by GET /review.

validation_failed: the title is missing or too long.

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired, or it was not created from the Audience settings page.

payment_required: the organization’s subscription needs attention.

scope_denied: the key lacks this route’s scope. ip_denied: the caller’s address is outside the key’s allowed ranges. app_not_available: Audience is not enabled for the organization.

individual_not_found.

not_found: no such route.

too_many_open_tasks. individual_merged: add the task on the person it was merged into.

rate_limited: the key spent its requests-per-minute budget; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.