Tasks

Create a task

Creates a one-off task (not associated with a sequence). The task is validated and synced to CRM automatically.

post/tasks

Request

  • Base URL: https://partner-api.nooks.in/v1
  • URL: https://partner-api.nooks.in/v1/tasks
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://oauth.nooks.in/oauth/authorize, token URL https://oauth.nooks.in/oauth/token, scopes: tasks:write)

Request body

Example request

{
  "data": {
    "action": "call",
    "dueAt": "2026-03-19T23:26:21.536Z",
    "ownerId": "KKLvN5wQoghWFwUvC75CZ12QM7I3",
    "prospectId": "770e8400-e29b-41d4-a716-446655440003",
    "note": "Test Call",
    "priority": "normal"
  }
}

Response

Task successfully created

idstring uuid required

Unique identifier for the task

action'call' | 'manual_email' | 'auto_email' | 'manual_email_reply' | 'auto_email_reply' | 'basic_task' | 'linkedin_connection_request' | 'manual_linkedin_connection_request' | 'manual_linkedin_message' | 'automatic_linkedin_message' | 'manual_sms' | 'auto_sms' required

Type of action for this task:

  • call: Phone call task
  • manual_email: Manually composed email
  • auto_email: Automatically sent email
  • manual_email_reply: Manual email reply
  • auto_email_reply: Automatic email reply
  • basic_task: Generic manual task
  • linkedin_connection_request: LinkedIn connection request
  • manual_linkedin_connection_request: Manual LinkedIn connection request
  • manual_linkedin_message: Manual LinkedIn message
  • automatic_linkedin_message: Automatically sent LinkedIn message
  • manual_sms: Manual SMS message
  • auto_sms: Automatically sent SMS message
completedboolean required

Whether the task has been completed

dueAtstring date-time required

When the task is due

notestring nullable required

Optional note or instructions for the task

statusstring nullable required

Current status of the task (pending, ready, finished, skipped, failed)

priority'low' | 'normal' | 'high' | 'urgent' required

Priority level of the task

createdAtstring date-time required

When the task was created

updatedAtstring date-time required

When the task was last updated

Example response

{
  "id": "dd0e8400-e29b-41d4-a716-446655440050",
  "action": "call",
  "dueAt": "2026-03-19T23:26:21.536Z",
  "note": "Initial outreach call",
  "status": "ready",
  "priority": "normal",
  "owner": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "prospect": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "sequence": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "sequenceState": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "sequenceStep": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "createdAt": "2026-03-18T10:00:00.000Z",
  "updatedAt": "2026-03-18T10:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.