Skip to main content
POST
Link Activity To Account
Points an activity at an account. Clears the activity’s deal_id in the same write — a deal always belongs to one account, so changing the account invalidates any existing deal link (an activity can’t point at a deal that isn’t under its account).

Auth

Requires a CRM manage scope and an active organization on the token. Any *:manage scope qualifies — in practice contacts:manage, deals:manage, companies:manage, or activities:manage.

Response

Errors

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

activity_id
string
required

The activity's id to link to an account.

Body

application/json

Body for POST /activities/{id}/link-account. account_id required.

account_id
string
required

Account to link the activity to.

Response

Successful Response

The response is of type Response Link Activity To Account Activities Activity Id Link Account Post · object.