Skip to main content

​
PUT a contact

PUT /user-api/v1/contacts/:id

​
Path Parameters

​
id
string
Contact ID

​
Headers

HeaderValue
Content-Typeapplication/json
x-rolodex-api-keyf1e2d3c4b5a697...

​
Query Parameters

​
include
string
Related data to include: emails, phone_numbers, companies, custom_fields, tags, lists, notes

​
Endpoint Example

PUT /user-api/v1/contacts/contact_67890?include=emails,custom_fields
Relationship fields (emails, phone_numbers, companies, tags, lists, notes, custom_fields) are replaced entirely with the provided values. To add to existing relationships, include all current values plus new ones.

​
Request

{
  "title": "Senior Product Manager",
  "is_starred": false,
  "emails": [
    {
      "email_address": "jane.smith@newcompany.com",
      "is_primary": true
    }
  ],
  "custom_fields": [
    {
      "id": "field_123",
      "value": 88
    }
  ]
}

​
Response

{
  "data": {
    "id": "contact_67890",
    "full_name": "Jane Smith",
    "first_name": "Jane",
    "last_name": "Smith",
    "title": "Senior Product Manager",
    "description": "Experienced product manager with a focus on SaaS products",
    "location": "New York, NY",
    "image_url": null,
    "linkedin_slug": "janesmith",
    "website_url": "https://janesmith.com",
    "x_slug": null,
    "facebook_slug": null,
    "instagram_slug": null,
    "birthday_day": null,
    "birthday_month": null,
    "birthday_year": null,
    "is_starred": false,
    "ignore_merge": false,
    "last_team_interaction": null,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T12:45:00Z"
  }
}