Guides
Creating your first contact
A practical first workflow for creating and enriching a contact record
Creating Your First Contact
Creating a contact is a good first integration workflow because it exercises authentication, organisation discovery, workspace discovery, and a write operation against a workspace-scoped resource.
Workflow
- Fetch organisations with
GET /organisation. - Fetch workspaces for the selected organisation with
GET /organisation/{orgId}/workspace. - Create a contact with
POST /organisation/{orgId}/workspace/{workspaceId}/contact. - Optionally attach an address with
POST /organisation/{orgId}/workspace/{workspaceId}/contact/{contactId}/address. - Optionally attach a communication method with
POST /organisation/{orgId}/workspace/{workspaceId}/contact/{contactId}/method.

