Contacts
Get a Contact by ID
GET /v3/marketing/contacts/{id}
Base url: https://api.sendgrid.com
This endpoint returns the full details and all fields for the specified contact.
The "Get Contacts by Emails" endpoint can be used to get the ID of a contact.
Authentication
- API Key
Headers
Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required
Path Parameters
id
string
default: None
required
Responses
object
id
string
required
first_name
string
last_name
string
unique_name
string
email
string
alternate_emails
array[string]
address_line_1
string
address_line_2
string
city
string
state_province_region
string
country
string
postal_code
string
phone_number
string
whatsapp
string
line
string
facebook
string
list_ids
array[string]
required
segment_ids
array[string]
required
custom_fields
object
created_at
string
required
updated_at
string
required
_metadata
object
self
string
A link to this object.
object
errors
array[object]
message
string
the error message
field
string or null
the field that generated the error
help
object
helper text or docs for troubleshooting
id
string
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}object
errors
array[object]
message
string
the error message
field
string or null
the field that generated the error
help
object
helper text or docs for troubleshooting
id
string
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}No response body.
object
errors
array[object]
message
string
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.