SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Create a follow-up task for a prospect in the Tasks service

Requires the Tasks service (402 service_not_active). For a connected app the task is assigned to the connecting member, who must hold service.tasks.create (403 otherwise), and is due on the prospect follow-up date.

POSThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/link-prospects/{prospect_id}/task

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

site_idstringrequired
prospect_idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Response

Response Body

idintegerTask id in the Tasks service.
category_idinteger | nullTask category. Always null for a prospect follow-up.
titlestringTask title, naming the linking domain and the website.
instructionsstring | nullThe page to get a link from, the page it should point at, the suggested wording and the prospect notes, one per line.
prioritystringAlways normal.
statusstringpublished when it was assigned to a member, draft when the key is not tied to a member.
due_atstring | nullMidday UTC on the prospect follow-up date, or null when it has none.
schedule_modestringAlways one_time.
starts_atstring | nullAlways null.
submission_modestringWhat the assignee sends back. Always file_and_text.
required_filesintegerFiles a submission must carry. Always 0.
allowed_submission_countinteger | nullMaximum attempts. Null means unlimited.
allow_late_submissionbooleanWhether work may be sent after the due date.
required_fieldsarray of objectsFields a submission must fill in. Always empty.
grading_schemestring | nullHow the work is graded. Always null.
max_scorenumber | nullHighest score. Always null.
weightnumberWeight in category rollups.
rubricarray of objectsGrading criteria. Always empty.
checklistarray of objectsSteps to tick off. Always empty.
custom_fieldsobjectWorkspace-defined task fields.
sourcestringWhere the task came from.
template_idinteger | nullTemplate the task came from. Always null.
duplicated_frominteger | nullTask it was copied from. Always null.
generated_from_task_idinteger | nullRecurring task it was generated from. Always null.
occurrence_datestring | nullOccurrence date for a recurring task. Always null.
created_byinteger | nullMember the task was created for, from the API key or connected app.
created_atstringWhen the task was created.
updated_atstringWhen the task was last changed.
attachmentsarray of objectsReference files on the task. Always empty.
assignment_countintegerPeople assigned when the task was first saved. 0, even when it was then assigned.
completed_countintegerAssignments completed. 0 for a new task.
assignee_user_idinteger | nullMember the task is assigned to, or null when nobody is.
linkstringDashboard path of the task. Only present when it was assigned.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/link-prospects/{prospect_id}/task \
--header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 201

{
"data": {
"id": 1682,
"category_id": null,
"title": "Follow up: partner.example.org link for Acme Bakery",
"instructions": "Page to get a link from: https://partner.example.org/resources\nSuggested wording: sourdough starter guide",
"priority": "normal",
"status": "published",
"due_at": null,
"schedule_mode": "one_time",
"starts_at": null,
"submission_mode": "file_and_text",
"required_files": 0,
"allowed_submission_count": null,
"allow_late_submission": true,
"required_fields": [
{}
],
"grading_scheme": null,
"max_score": null,
"weight": 1,
"rubric": [
{}
],
"checklist": [
{}
],
"custom_fields": {},
"source": "manual",
"template_id": null,
"duplicated_from": null,
"generated_from_task_id": null,
"occurrence_date": null,
"created_by": 4121,
"created_at": "2026-10-01T17:43:32.570Z",
"updated_at": "2026-10-01T17:43:32.570Z",
"attachments": [
{}
],
"assignment_count": 0,
"completed_count": 0,
"assignee_user_id": 4121,
"link": "/tasks/1682"
}
}