Enrich Email
POST/v1/enrich/email
Enrich a contact with an email address from upcell’s database.
Request Body
| Field | Type | Description | Required |
|---|---|---|---|
firstName | string | The first name of the contact to enrich. | ✅ Yes |
lastName | string | The last name of the contact to enrich. | ✅ Yes |
companyDomain | string | The 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 Code | Message | Description |
|---|---|---|
| 400 | Invalid Request | Verify your request is properly formatted |
| 401 | Unauthorized | Verify you are using a valid API key |
| 500 | Internal Server Error | An unexpected error occurred. |
Example Error Response
{
"error": {
"code": 400,
"message":"FirstName, LastName, and CompanyDomain are required for email enrichment"
}
}
Request
Responses
- 200
Successful response