Menu

Expand
Rate this page:

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 Identifier" 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

The ID of the Event Webhook you want to retrieve.

default: None
required

Responses

object
id
string
required
first_name
string
last_name
string
unique_name
string
email
string
phone_number_id
string
external_id
string
anonymous_id
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

required
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

required
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
Loading Code Sample...
        
        

        Get a Contact by ID

        Rate this page:

        Need some help?

        We all do sometimes. Get help now from the Twilio SendGrid Support Team.

        Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.

        Loading Code Sample...
              
              
              

              Thank you for your feedback!

              Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

              Sending your feedback...
              🎉 Thank you for your feedback!
              Something went wrong. Please try again.

              Thanks for your feedback!

              thanks-feedback-gif