curl --request POST \
--url https://api.gospott.com/tasks/_raw \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"content": "Follow up with candidate about interview availability",
"dueDate": "2024-12-31T23:59:59.000Z",
"assignedToUserId": "550e8400-e29b-41d4-a716-446655440000",
"links": [
{
"taskLinkId": null,
"entityType": "candidate",
"entityId": "550e8400-e29b-41d4-a716-446655440000"
}
]
}
'{
"createdBy": {
"id": "<string>",
"name": "<string>",
"avatarUrl": "<string>",
"deactivatedAt": "2023-11-07T05:31:56Z"
},
"assignedTo": {
"id": "<string>",
"name": "<string>",
"avatarUrl": "<string>",
"deactivatedAt": "2023-11-07T05:31:56Z"
},
"source": "MANUAL",
"metadata": {
"type": "GENERIC_TASK",
"outreachSequenceId": "<string>",
"outreachSequenceName": "<string>",
"outreachSequenceRunId": "<string>"
},
"links": {
"candidates": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"middleName": "<string>",
"secondLastName": "<string>",
"avatarUrl": "<string>"
}
],
"vacancies": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"companyId": "<string>",
"companyName": "<string>",
"companyLogoUrl": "<string>"
}
],
"clients": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"logoUrl": "<string>"
}
],
"users": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"avatarUrl": "<string>",
"deactivatedAt": "2023-11-07T05:31:56Z"
}
],
"teams": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"avatarUrl": "<string>"
}
],
"clientContacts": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"middleName": "<string>",
"secondLastName": "<string>",
"avatarUrl": "<string>",
"candidateId": "<string>",
"companyId": "<string>",
"companyName": "<string>",
"companyLogoUrl": "<string>"
}
],
"opportunities": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"logoUrl": "<string>"
}
}
]
},
"id": "<string>",
"content": "<string>",
"dueDate": "2023-11-07T05:31:56Z",
"isCompleted": true,
"completedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"labels": [
{
"id": "<string>",
"name": "<string>",
"colorHex": "<string>"
}
]
}Create a new task with optional due date, assignee, and links to entities (candidates, vacancies, clients, etc.).
curl --request POST \
--url https://api.gospott.com/tasks/_raw \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"content": "Follow up with candidate about interview availability",
"dueDate": "2024-12-31T23:59:59.000Z",
"assignedToUserId": "550e8400-e29b-41d4-a716-446655440000",
"links": [
{
"taskLinkId": null,
"entityType": "candidate",
"entityId": "550e8400-e29b-41d4-a716-446655440000"
}
]
}
'{
"createdBy": {
"id": "<string>",
"name": "<string>",
"avatarUrl": "<string>",
"deactivatedAt": "2023-11-07T05:31:56Z"
},
"assignedTo": {
"id": "<string>",
"name": "<string>",
"avatarUrl": "<string>",
"deactivatedAt": "2023-11-07T05:31:56Z"
},
"source": "MANUAL",
"metadata": {
"type": "GENERIC_TASK",
"outreachSequenceId": "<string>",
"outreachSequenceName": "<string>",
"outreachSequenceRunId": "<string>"
},
"links": {
"candidates": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"middleName": "<string>",
"secondLastName": "<string>",
"avatarUrl": "<string>"
}
],
"vacancies": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"companyId": "<string>",
"companyName": "<string>",
"companyLogoUrl": "<string>"
}
],
"clients": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"logoUrl": "<string>"
}
],
"users": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"avatarUrl": "<string>",
"deactivatedAt": "2023-11-07T05:31:56Z"
}
],
"teams": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"avatarUrl": "<string>"
}
],
"clientContacts": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"middleName": "<string>",
"secondLastName": "<string>",
"avatarUrl": "<string>",
"candidateId": "<string>",
"companyId": "<string>",
"companyName": "<string>",
"companyLogoUrl": "<string>"
}
],
"opportunities": [
{
"taskLinkId": "<string>",
"isMention": true,
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"logoUrl": "<string>"
}
}
]
},
"id": "<string>",
"content": "<string>",
"dueDate": "2023-11-07T05:31:56Z",
"isCompleted": true,
"completedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"labels": [
{
"id": "<string>",
"name": "<string>",
"colorHex": "<string>"
}
]
}API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.
The content/description of the task.
"Follow up with candidate about interview availability"
The due date for the task, or null if no due date
"2024-12-31T23:59:59.000Z"
The user ID to assign the task to, or null for unassigned tasks
"550e8400-e29b-41d4-a716-446655440000"
Links to related entities (candidates, vacancies, clients, etc.)
Show child attributes
Task created successfully
The user who created the task.
Show child attributes
The user assigned to complete the task, or null if unassigned.
Show child attributes
MANUAL, AI_SUGGESTION, OUTREACH_SEQUENCE_STEP Show child attributes
All entities linked to this task, grouped by entity type. Links can be created explicitly or via @mentions in the task content.
Show child attributes
Show child attributes