Update Contact

Updates an existing contact identified by phone number. Merges provided fields with existing data.

POST/api/v1/contact/update/:phone

Recommendation

Only fields you want to change need to be provided. Existing attributes are merged — not replaced.

Body Parameters

1 parameter

:phonestringrequired

Phone number in path (e.g. +917838343515).

Request Body Schema

application/json

phonestringrequired

Phone number of the contact to update (with country code)

Example:+917838343515

first_namestringoptional

Updated first name

Example:Mary

last_namestringoptional

Updated last name

Example:Johnson

attributesobjectoptional

Custom key-value properties to merge (JSON object)

Example:{"city": "Boston", "tier": "premium"}

Response Payload

200 OKapplication/json

successbooleanrequired

Whether request succeeded

data.contact.iduuidrequired

Contact UUID

data.contact.phone_numberstringrequired

Phone number

data.contact.updated_atdatetimerequired

Last updated timestamp

Code Snippets & Examples

curl -X POST "https://app.chatofy.in/api/v1/contact/update/+917838343515" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Mary","attributes":{"city":"Boston"}}'

Was this endpoint guide helpful?

Enterprise SLA•99.99% Guaranteed

curl -X POST "https://app.chatofy.in/api/v1/contact/update/+917838343515" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Mary","attributes":{"city":"Boston"}}'

200 OKapplication/json

{
  "success": true,
  "data": {
    "contact": {
      "id": "d9b23f28-0db4-...",
      "phone_number": "+917838343515",
      "first_name": "Mary",
      "last_name": null,
      "attributes": {
        "city": "Boston"
      },
      "updated_at": "2026-06-06T12:05:00.000Z"
    }
  },
  "message": "Contact updated successfully"
}

curl -X POST "https://app.chatofy.in/api/v1/contact/update/+917838343515" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"first_name":"Mary","attributes":{"city":"Boston"}}'

{ "success": true, "data": { "contact": { "id": "d9b23f28-0db4-...", "phone_number": "+917838343515", "first_name": "Mary", "last_name": null, "attributes": { "city": "Boston" }, "updated_at": "2026-06-06T12:05:00.000Z" } }, "message": "Contact updated successfully" }