> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mailofly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Contact

> Update a contact's email, name, subscription status, or custom properties.

Update an existing contact profile within your workspace.

### Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the contact.
</ParamField>

### Body Parameters

<ParamField body="email" type="string">
  New email address for the contact.
</ParamField>

<ParamField body="firstName" type="string">
  First name.
</ParamField>

<ParamField body="lastName" type="string">
  Last name.
</ParamField>

<ParamField body="unsubscribed" type="boolean">
  Set whether the contact is globally unsubscribed.
</ParamField>

<ParamField body="properties" type="object">
  Key-value custom attributes for personalization.
</ParamField>

### Response

<ResponseField name="data" type="object">
  <ResponseField name="id" type="string">The contact ID.</ResponseField>
  <ResponseField name="email" type="string">Contact email.</ResponseField>
  <ResponseField name="unsubscribed" type="boolean">Unsubscribe status.</ResponseField>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.mailofly.com/api/v1/contacts/cnt_123 \
    -H "Authorization: Bearer mf_live_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "firstName": "Alex",
      "properties": {
        "plan": "enterprise"
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "id": "cnt_123",
      "email": "alex@example.com",
      "firstName": "Alex",
      "unsubscribed": false,
      "properties": {
        "plan": "enterprise"
      }
    }
  }
  ```
</ResponseExample>


## Related topics

- [Update Contact Topics](/api/contacts/update-contact-topics.md)
- [Update Contact Property](/api/contact-properties/update-contact-property.md)
- [Contacts](/audience/contacts.md)
- [Properties](/audience/properties.md)
- [Update Email](/api/emails/update-email.md)