Skip to main content
POST
/
api
/
v1
/
accounts
/
{account_id}
/
follow_up_tasks
Create a follow-up task
curl --request POST \
  --url https://connect.voxys.ai/api/v1/accounts/{account_id}/follow_up_tasks \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "title": "Follow up with prospect",
  "description": "Call back after proposal review.",
  "due_at": "2026-06-15T10:00:00Z",
  "priority": "medium",
  "assigned_to_id": 1,
  "taskable_type": "Lead",
  "taskable_id": 42
}
'
{
  "id": 20,
  "title": "Follow up with prospect",
  "description": "Call back after proposal review.",
  "status": "pending",
  "priority": "medium",
  "due_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "taskable_type": "Lead",
  "taskable_id": 42,
  "assigned_to": {
    "id": 1,
    "name": "Jane Smith",
    "email": "jane@example.com",
    "avatar_url": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.voxys.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
​
created_at
string<date-time>
​
updated_at
string<date-time>