Skip to main content
POST
Create one-off tasks in bulk
One task per contact, at most 500.

Authorizations

x-api-key
string
header
required

Team-scoped API key generated in the Salesfinity dashboard under Settings -> Connections & API. A missing or invalid key returns HTTP 403.

Body

application/json
user_id
string
required

The team member this call acts as. Must be an active member of the team the API key belongs to.

Example:

"507f1f77bcf86cd799439011"

action
enum<string>
required
Available options:
call,
manual_email,
generic,
linkedin_connect,
linkedin_message,
linkedin_view,
linkedin_interact,
meeting,
sms
due_at
string<date-time>
required

ISO 8601, and must be in the future. Values more than 365 days out are rejected, and so is a value already in the past — with a few minutes of slack, so a client computing "now" is not caught out by its own request latency.

contacts
string[]
required

One task per contact. At most 500.

priority
enum<string>
default:medium
Available options:
high,
medium,
low
assignee_id
string

Assignee. Defaults to user_id.

subject
string
note
string

Response

Success.

The outcome of an action. Shape varies by endpoint — for example enable returns the sequence and how many enrollments it activated, and a bulk verb returns how many rows it moved.