Skip to content
Hoursmith Docs
APIReferenceClients

Update a client contact

Update a client contact. Requires Manager, Admin or Owner. Member tokens receive 403 forbidden_scope — Members have no client access in Hoursmith. Write scope. Partial update: only supplied keys change. The contact must belong to the path client (else 404). Affects future invoice emails only. Confirmation rule (stateless, from the request alone): portalEnabled true requires confirmPortalAccess: true (the email may sign in to the client portal and see this client's invoices); isBillingDefault true requires confirmBillingDefault: true (invoice emails and automatic reminders default to this contact unless the client has its own billingEmail); on PATCH, supplying email requires confirmEmailChange: true. A missing acknowledgement is a 422 whose `fields` name the flag and why; nothing is changed. Turning a flag or portal access off never needs confirmation.

PATCH
/clients/{id}/contacts/{contactId}

Authorization

BearerAuth
AuthorizationBearer <token>

Personal Access Token. Mint at Settings → API. Token shape: hsk_<env>_<prefix12>_<secret32>.

In: header

Path Parameters

id*string

Client UUID.

contactId*string

Contact UUID.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Partial update: only supplied keys change. At least one of email, name, title, phone, isPrimary, isBillingDefault, portalEnabled.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/clients/497f6eca-6276-4993-bfeb-53cbbbba6f08/contacts/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",    "email": "user@example.com",    "name": "string",    "title": "string",    "phone": "string",    "isPrimary": true,    "isBillingDefault": true,    "portalEnabled": true,    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
Was this page helpful?