Contacts
Create Contact
POST
a contact
POST
/user-api/v1/contacts
Headers
Header | Value |
---|---|
Content-Type | application/json |
x-rolodex-api-key | f1e2d3c4b5a697... |
Required Fields
Contact’s first name.
Request
Copy
{
"first_name": "Jane",
"last_name": "Smith",
"title": "Product Manager",
"location": "New York, NY",
"linkedin_slug": "janesmith",
"website_url": "<https://janesmith.com>",
"description": "Experienced product manager with a focus on SaaS products",
"is_starred": true,
"emails": [
{
"email_address": "jane@example.com",
"is_primary": true
},
"jane.smith@work.com"
],
"phone_numbers": [
{
"phone_number": "5551234567",
"country_code": "+1",
"is_primary": true
},
"+15559876543"
],
"companies": [
{
"id": "company_123",
"is_active": true,
"start_date": "2023-01-15",
"title": "Senior Product Manager"
},
"company_456"
],
"tags": ["tag_123", "tag_456"],
"lists": ["list_789"],
"notes": ["note_101"],
"custom_fields": [
{
"id": "field_123",
"value": 95
},
{
"id": "field_456",
"value": "option_789"
}
]
}
Response
Copy
{
"data": {
"id": "contact_67890",
"full_name": "Jane Smith",
"first_name": "Jane",
"last_name": "Smith",
"title": "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": true,
"ignore_merge": false,
"last_team_interaction": null,
"created_at": "2025-01-15T10:30:00Z",
"updated_at": "2025-01-15T10:30:00Z",
"emails": [
{
"id": "email_234",
"email_address": "jane@example.com",
"is_primary": true
},
{
"id": "email_235",
"email_address": "jane.smith@work.com",
"is_primary": false
}
],
"phone_numbers": [
{
"id": "phone_567",
"phone_number": "5551234567",
"country_code": "+1",
"is_primary": true
},
{
"id": "phone_568",
"phone_number": "5559876543",
"country_code": "+1",
"is_primary": false
}
],
"companies": [
{
"id": "company_123",
"name": "Tech Corp",
"title": "Senior Product Manager",
"is_active": true,
"start_date": "2023-01-15"
},
{
"id": "company_456",
"name": "Startup Inc",
"title": null,
"is_active": null,
"start_date": null
}
],
"tags": [
{
"tag": {
"id": "tag_123",
"name": "Lead"
}
},
{
"tag": {
"id": "tag_456",
"name": "Hot Prospect"
}
}
],
"lists": [
{
"list": {
"id": "list_789",
"name": "Q1 Targets"
}
}
],
"notes": [
{
"note": {
"id": "note_101",
"body": "Initial outreach completed"
}
}
],
"custom_fields": [
{
"id": "field_123",
"name": "Lead Score",
"field_type": "NUMERIC",
"value": 95
},
{
"id": "field_456",
"name": "Status",
"field_type": "SINGLE_SELECT",
"value": {
"id": "option_789",
"value": "Qualified"
}
}
]
}
}
Assistant
Responses are generated using AI and may contain mistakes.