Skip to main content
POST
Report a wrong email address
Use this endpoint when one of your users finds that an email address Pipecorn enriched is wrong: it bounces, it is at the wrong company, or it belongs to someone else. Pipecorn removes the address from the contact and, by default, searches for another one of the same type, work or personal, with the providers that did not give the wrong address.

Flow

  1. Send the contact’s linkedin_url, the wrong email and a reason.
  2. The response says whether a new search started (replacement: "searching").
  3. Poll status_url until status is finished, or wait for the webhook. It carries the new address in email (or personal_email), or no address when none was found.

Credits

Reporting is free. The new search costs what an enrichment of the same type costs, and only when it finds an address: 3 credits for a work email, 9 for a personal email. A personal email search also needs the account’s consent to personal email enrichment. Send "find_replacement": false to report the address without searching.

Authorizations

X-API-KEY
string
header
required

Your API key

Headers

Idempotency-Key
string

A unique value you generate per operation, such as a UUID. Retrying with the same key and the same body returns the stored response instead of running the request again, so a retry after a timeout never charges twice. Successful responses are kept for 24 hours; a failed request is not stored and can be retried with the same key.

Maximum string length: 255
Example:

"4f1c2e9a-8a7d-4c1b-9f63-2d6e0b5a7c11"

Body

application/json
linkedin_url
string
required

LinkedIn profile URL of the contact, as sent to the enrichment.

Example:

"https://www.linkedin.com/in/william-hewish"

email
string<email>
required

The wrong address, as Pipecorn returned it: a work email or a personal email. Use the full address.

Example:

"william.hewish@acme.com"

reason
enum<string>
required

invalid_address: the address bounces or does not exist. wrong_domain: the address is at a company the person no longer works for, or at the wrong company. wrong_person: the address belongs to someone else.

Available options:
invalid_address,
wrong_domain,
wrong_person
find_replacement
boolean
default:true

Search for another address. Send false to only report the address.

webhook_url
string<uri>

Where to send the result of the new search. Defaults to the webhook_url of the original enrichment.

Response

The address is reported

enrichment_id
string<uuid>

The contact's enrichment ID, for GET /contacts/{id}

reported
boolean

Always true

replacement
enum<string>

searching: a new email search of the same type is running. other_email_kept: the contact still has another verified email of the same type, so no search ran. not_allowed: your plan or role does not allow this email enrichment, or the account has not consented to personal email enrichment. insufficient_credits: fewer credits left than the search costs (3 for a work email, 9 for a personal email). skipped: you sent find_replacement: false.

Available options:
searching,
other_email_kept,
not_allowed,
insufficient_credits,
skipped
status_url
string<uri>

GET /contacts/{id} for this contact