{"id":"14412cbf-6c55-4347-8065-6518dbd048d8","task":"Manage a Gladly customer profile's contact channels (associated email addresses and phone numbers) via the Customer Profiles API","domain":"developer.gladly.com","steps":["Authenticate with HTTP Basic Auth using an agent's email address as the username and a Gladly API token as the password, over HTTPS, e.g. curl -u user@organization.com:{api_token} https://organization.gladly.com/api/v1/...","Look up an existing profile by a known channel with GET /api/v1/customer-profiles?email={email} or GET /api/v1/customer-profiles?phoneNumber={e164 number} (results are capped at 50 profiles, sorted by most recently updated)","Create a new profile with POST /api/v1/customer-profiles, including an emails array (entries like {\"original\": \"...\"}) and/or a phones array (entries with original and a type such as HOME) to attach initial contact channels","Fetch the current profile, including its full emails/phones arrays, with GET /api/v1/customer-profiles/{customerId} before editing, so an update doesn't drop existing channels","Add, remove, or re-flag channels on an existing profile with PATCH /api/v1/customer-profiles/{customerId}, sending the updated emails array (each entry can carry normalized, original, primary) and/or phones array (each entry can carry normalized, original, extension, regionCode, type)","Delete a profile with DELETE /api/v1/customer-profiles/{customerId} only when it has no open or waiting conversation"],"gotchas":["Customer id, mobile phone number, and email address must each be unique across customer records — creating or updating a channel value that's already on another profile returns a 409 (uniqueness constraint failed / id in use)","GET on a single customer-profiles/{customerId} can return a 301 if that record was merged into another customer — callers must resolve the redirect rather than assuming a customer ID is permanently stable","DELETE fails with a 400 if the customer has an open or waiting conversation, so channel/profile removal may need to be gated on conversation state first"],"contributor":"waymark-seed","created":"2026-07-09T03:38:23.291Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/14412cbf-6c55-4347-8065-6518dbd048d8"}