Update a contact

client.contacts.update(, , ?): ContactUpdateResponse { contact, status }

PUT/api/v2/contacts/{phone_number}

Update an existing contact

ParametersExpand Collapse

phoneNumber: string

body: ContactUpdateParams { assigned_to_email, assignedToEmail, company_name, 9 more }

assigned_to_email?: string

Email of assigned user (preferred)

DeprecatedassignedToEmail?: string

Deprecated, use assigned_to_email

company_name?: string

Company name (preferred)

DeprecatedcompanyName?: string

Deprecated, use company_name

custom_variables?: Record<string, string>

Custom key-value pairs. Merged with existing variables (not replaced).

first_name?: string

Contact's first name (preferred)

DeprecatedfirstName?: string

Deprecated, use first_name

last_name?: string

Contact's last name (preferred)

DeprecatedlastName?: string

Deprecated, use last_name

sendblue_number?: string

Associated Sendblue phone number (preferred)

DeprecatedsendblueNumber?: string

Deprecated, use sendblue_number

tags?: Array<string>

ReturnsExpand Collapse

ContactUpdateResponse { contact, status }

contact?: Contact { assigned_to_email, company_name, created_at, 7 more }

assigned_to_email?: string

Email of assigned user

company_name?: string

Company name

created_at?: string

When the contact was created

formatdate-time

custom_variables?: Record<string, string>

Custom key-value pairs stored on the contact. Keys are human-readable labels.

first_name?: string

First name

last_name?: string

Last name

phone?: string

Phone number in E.164 format

sendblue_number?: string

Associated Sendblue phone number

tags?: Array<string>

Tags associated with the contact

verified?: boolean

Whether the contact is verified

status?: string

Update a contact

import SendblueAPI from 'sendblue';

const client = new SendblueAPI({
  apiKey: process.env['SENDBLUE_API_API_KEY'], // This is the default and can be omitted
  apiSecret: process.env['SENDBLUE_API_API_SECRET'], // This is the default and can be omitted
});

const contact = await client.contacts.update('+1234567890');

console.log(contact.contact);

{
  "contact": {
    "assigned_to_email": "[email protected]",
    "company_name": "Example Corp",
    "created_at": "2024-01-15T10:30:00Z",
    "custom_variables": {
      "Lead Source": "Website",
      "Plan": "Enterprise"
    },
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "sendblue_number": "+1987654321",
    "tags": [
      "customer",
      "vip"
    ],
    "verified": true
  },
  "status": "OK"
}

Returns Examples

{
  "contact": {
    "assigned_to_email": "[email protected]",
    "company_name": "Example Corp",
    "created_at": "2024-01-15T10:30:00Z",
    "custom_variables": {
      "Lead Source": "Website",
      "Plan": "Enterprise"
    },
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "sendblue_number": "+1987654321",
    "tags": [
      "customer",
      "vip"
    ],
    "verified": true
  },
  "status": "OK"
}