Gallery Platform API
Reference

Create a party

Creates a party (a person or organisation) in the gallery.

POST
/gallery/parties

Creates a party (a person or organisation) in the gallery.

Authorization

bearerAuth contacts:create, gallery:read
AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: contacts:create, gallery:read

Header Parameters

Idempotency-Key?string

Optional. Send a unique key per logical operation to make retries safe: a retry with the same key replays the stored success for 14 days instead of re-running the write. Reusing a key with a different body returns 400.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Create a party.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "id": "string",  "name": "string",  "kind": "person",  "contact_type": "collector",  "company": "string",  "city": "string",  "email": "string",  "phone": "string",  "notes": "string",  "lead_status": "new",  "form_of_address": "string",  "locale": "string",  "do_not_email": true,  "do_not_sms": true,  "acquisition_source": "inquiry",  "acquired_at": "string",  "archived_at": "string",  "ulan": "string",  "wikidata": "string",  "isni": "string",  "viaf": "string",  "lei": "string",  "assignee_ids": [    "string"  ],  "collector_profile": {    "collecting_focus": "string",    "budget_band": "string",    "wishlist_notes": "string",    "preferred_contact_method": "string",    "vip": true,    "tax_exempt": true,    "created_at": "string",    "updated_at": "string"  },  "institution_profile": {    "institution_kind": "string",    "tax_exempt": true,    "acquisition_process": "string",    "primary_contact_name": "string",    "created_at": "string",    "updated_at": "string"  },  "last_interaction_at": "string",  "last_interaction_type": "note",  "roles": [    {      "role": "collector",      "valid_from": "string"    }  ],  "custom_fields": {    "property1": null,    "property2": null  },  "save_state": "new",  "metadata": {    "property1": "string",    "property2": "string"  },  "created_at": "string",  "updated_at": "string"}