Activities

Create a client activity

Add a manual activity to the client timeline. Activities are immutable once created.

post/v1/clients/{clientId}/activities

Request

  • Base URL: https://api.frihet.io
  • URL: https://api.frihet.io/v1/clients/{clientId}/activities
  • Auth: API key in header X-API-Key

Path parameters

clientIdstring required

Client unique identifier

Request body

type'call' | 'email' | 'email_sent' | 'meeting' | 'note_added' | 'task' | 'stage_changed' | 'client_created' required

CRM activity types accepted for manual/API-created entries. The legacy email value is stored as email_sent. Invoice, quote and expense system activity types are auto-generated.

titlestring required

Descriptive title for the activity

descriptionstring

Detailed description

metadataobject

Free-form additional data. For task activities, use string fields such as status and dueDate to mirror the client's current next action.

Example request

{
  "title": "Follow-up call on Q2 budget",
  "description": "Discussed budget terms. Awaiting confirmation."
}

Response

Activity created

idstring

Unique identifier

typestring

Activity type (manual or system-generated)

titlestring
descriptionstring
metadataobject
createdAtstring date-time

Changes

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