Skip to main content
POST
Create a follow-up task

Authorizations

api_access_token
string
header
required

API access token for authentication. Obtain from your Voxys Connect profile settings.

Path Parameters

account_id
integer
required

The numeric ID of the account.

Body

application/json
title
string
required
Example:

"Follow up with prospect"

description
string | null
Example:

"Call back after proposal review."

due_at
string<date-time> | null
Example:

"2026-06-15T10:00:00Z"

priority
enum<string>
default:medium
Available options:
low,
medium,
high
assigned_to_id
integer | null
Example:

1

taskable_type
enum<string>
Available options:
Lead,
FunnelCard,
Conversation,
Contact
Example:

"Lead"

taskable_id
integer | null
Example:

42

Response

Task created.

id
integer
Example:

20

title
string
Example:

"Follow up with prospect"

description
string | null
Example:

"Call back after proposal review."

status
enum<string>
Available options:
pending,
completed,
snoozed
Example:

"pending"

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

"medium"

due_at
string<date-time> | null
completed_at
string<date-time> | null
taskable_type
string
Example:

"Lead"

taskable_id
integer
Example:

42

assigned_to
object | null
created_at
string<date-time>
updated_at
string<date-time>