Activities

Log an activity on a contact

Log a manual activity or note on a workspace-owned contact. Only hand-loggable activity types are accepted; the row is stamped metadata.source=public_api. Outbound types advance the contact's last_contacted_at. Requires the activities.write scope.

post/contacts/{id}/activities

Request

  • Base URL: https://www.sagaris.ai/api/v1
  • URL: https://www.sagaris.ai/api/v1/contacts/{id}/activities
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The contact id, which must belong to the key's workspace.

Headers

Idempotency-Keystring

Opaque client-supplied key. A retry with the same key replays the original response instead of writing again.

Request body

type'note_added' | 'call_made' | 'call_received' | 'voicemail_left' | 'meeting_booked' | 'meeting_completed' | 'sms_sent' | 'linkedin_message' required

A hand-loggable activity type.

subjectstring

Required for every type except note_added (where it defaults to "Note").

bodystring

Required when type is note_added; optional otherwise.

metadataobject

Optional caller metadata; source and api_key_id are stamped by the server.

Response

The created activity.

errorunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.