Karia
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

  1. Fetch organisations with GET /organisation.
  2. Fetch workspaces for the selected organisation with GET /organisation/{orgId}/workspace.
  3. Create a contact with POST /organisation/{orgId}/workspace/{workspaceId}/contact.
  4. Optionally attach an address with POST /organisation/{orgId}/workspace/{workspaceId}/contact/{contactId}/address.
  5. Optionally attach a communication method with POST /organisation/{orgId}/workspace/{workspaceId}/contact/{contactId}/method.

On this page