Email Append Tutorial

Overview

Email Append is a real-time solution for retrieving verified email addresses based on a person and address. The matches returned does not always match all of the data sent in the request, but rather the best possible match given the requested information and the available data.

Email Append URI

The Email Append URI accepts a person’s name and address and returns an email address associated with the information.

Required Information

The Email Append URI requires you to have an Authorization Token. If you have not retrieved an Authorization Token yet, follow the Authorization Tutorial before continuing.

The Email Append URI, like all of the solution URIs, also requires you to have an API Key. If you do not know your API Key, contact support to retrieve it. The API Key should be provided in the request header with the header attribute: x-api-key

The Email Append URI must be used with a POST request, where the request payload contains the name of the person being searched for and their address. Example Request URL The URL for the Email Append URI is: https://api.thedatagroup.com/{version}/sync/append/email, where {version} is the API Version you wish to use.

Request Headers

Request Payload

The request payload for the Email Append URI must contain the first_name, last_name, and address_1 attributes. It must also contain either the zipcode attribute or both the city and state attributes.

{
 "first_name": "Richard",
 "last_name": "Young",
 "address_1": "4689 Lakewood Drive",
 "city": "Fleming Island",
 "state": "FL"
}

cURL Example

To query the Email Append URI, you can use one of the provided SDKs, a REST Client, or a simple cURL command. Below is an example of the cURL command for the example input information.

curl -X POST -H "Content-Type: application/json" -H "AuthorizationToken: {your_token}" -H "x-api-key: {your_key}" -H "Cache-Control: no-cache" -d '{
 "first_name": "Richard",
 "last_name": "Young",
 "address_1": "4689 Lakewood Drive",
 "city": "Fleming Island",
 "state": "FL"
 }' "https://api.thedatagroup.com/v3/sync/append/email"

Response Payload

The response payload for the Email Append URI will contain the email address for the given information, as well as all of the name and address data associated with that email address.

{
 "first_name": "Richard",
 "last_name": "Young",
 "email": "richard.young@fakeemail.com",
 "address": {
 "street_number": "4689",
 "street_name": "Lakewood",
 "street_type": "DR",
 "city": "Fleming Island",
 "zipcode": "32003",
 "state": "FL"
 }
}