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.
POST
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/link-prospects/{prospect_id}/taskRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
site_idstringrequiredprospect_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional 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" }}