v1

latestOpenAPI 3.0.22026-08-045831103.6 KB

Activities

Complete/reopen activity

Mark an activity as completed, or reopen a previously completed one. Body is optional; completed defaults to true. Reopening (completed: false) a non-custom activity (created automatically from a stage template) that is no longer on the deal's current stage is rejected with 400 — the internal service would otherwise soft-delete it instead of reopening it. Completions made through this endpoint carry no user attribution (completed_by stays null). Requires the ACTIVITIES_API feature flag and an API key with the activities:write scope.

post/v2/activities/{id}/complete

Path parameters

idstring uuid required

Example:8feade82-d77b-4e8b-9d35-fd43e972b5c8

UUID

Headers

api-tokenstring required

API Token

Request body

completedboolean

true to complete the activity, false to reopen it.

Example request

{
  "completed": true
}

Response

The updated activity object

statusinteger

Response status

Example response

{
  "status": 200,
  "data": {
    "id": "8feade82-d77b-4e8b-9d35-fd43e972b5c8",
    "title": "Call the customer back",
    "type": "CALL",
    "content": "Discuss the renewal proposal.",
    "due_at": "2024-01-20T14:00:00.000Z",
    "custom": true,
    "stage_id": "8feade82-d77b-4e8b-9d35-fd43e972b5c8",
    "created_at": "2020-01-01T14:15:00.000000+00:00",
    "deal": {
      "id": "8feade82-d77b-4e8b-9d35-fd43e972b5c8",
      "status": "OPEN",
      "origin_id": "8feade82-d77b-4e8b-9d35-fd43e972b5c8",
      "stage_id": "8feade82-d77b-4e8b-9d35-fd43e972b5c8",
      "contact": {
        "id": "8feade82-d77b-4e8b-9d35-fd43e972b5c8",
        "name": "Jane Doe"
      }
    }
  }
}