Skip to main content

Enrich Email

POST 

/v1/enrich/email

Enrich a contact with an email address from upcell’s database.

Request Body

FieldTypeDescriptionRequired
firstNamestringThe first name of the contact to enrich.✅ Yes
lastNamestringThe last name of the contact to enrich.✅ Yes
companyDomainstringThe company domain of the contact to enrich.✅ Yes

Example Request (JSON)

{
"firstName": "Mark",
"lastName": "Bedard",
"companyDomain": "upcell.io"
}


Response

The response returns an object with the email and a flag indicating if the email is verified.

Example Success Response

{
"email": "mark.bedard@upcell.io",
"verified": true
}


Error Handling

The API returns appropriate error messages with status codes if something goes wrong.

Error CodeMessageDescription
400Invalid RequestVerify your request is properly formatted
401UnauthorizedVerify you are using a valid API key
500Internal Server ErrorAn unexpected error occurred.

Example Error Response

{
"error": {
"code": 400,
"message":"FirstName, LastName, and CompanyDomain are required for email enrichment"
}
}

Request

Responses

Successful response