PitchWhip in Clay,
Zapier and your own tools.

Answers with the key's name when the key works. Zapier uses it to test the connection.

Cost. Free.

{ "ok": true, "key": { "id": "ak_…", "name": "Clay" } }

The opening line of a cold call and the first line of a cold email for one person, written with PitchWhip's opener rules and your pitch profile.

Cost. One opener from your daily allowance, as in the extension. Live trials can use it.

• linkedin_url A LinkedIn profile link. Used only to find someone PitchWhip already holds for your account (a reveal, a list or a map). PitchWhip never opens the link.
• name, company, title Who the person is. Needed when PitchWhip doesn't know them yet; title is optional.
• your_pitch Optional. What you sell, for this call only, in place of your pitch profile's.

{
  "name": "Pat Lee",
  "company": "Northwind Care",
  "title": "Operations Director",
  "your_pitch": "Rota software for care homes"
}

{
  "call_opener": "Hi Pat, it's Sam from Brightline. …",
  "email_opener": "Pat, teams like Northwind's lose hours every week to manual rotas, …"
}

The best-fit senior people at a company for the role you name, with their LinkedIn profile links. It uses Map a whole company and keeps them on your account map of that company.

Cost. Needs Account Maps. People added to the map count against the month's mapped-people allowance (10 at most a request), a new company against the month's company look-ups. A company you have already mapped is answered from your map, free.

• company_domain The company's website, like northwind.example. Best, as a name can match several companies.
• company_name The company's name, when you don't have the website.
• role_hint Optional. Who you sell to, like "Head of Sales" or "finance".
• max Optional. How many people to return, 1 to 10. Default 3.

{ "company_domain": "northwind.example", "role_hint": "Head of Operations" }

{
  "status": "done",
  "company": { "name": "Northwind Care", "domain": "northwind.example" },
  "buyers": [
    { "name": "Alex Shaw", "title": "Chief Operating Officer", "department": "Operations",
      "seniority": "C-level", "country": "United Kingdom",
      "linkedin_url": "https://www.linkedin.com/in/…" }
  ]
}

A large company can take longer than one request. Then the answer is 202 with { "status": "pending", "id": "by_123" }: call GET /buyer/by_123 until status is done.

No phone number or email is looked up here. Use /reveal for that.

Carries on a buyer request that answered pending, and answers the same shape when it is done.

Cost. Nothing more than the request it finishes.

{ "status": "done", "company": { … }, "buyers": [ … ] }

Starts a look-up of one person's work phone, work email or both.

Cost. One reveal for each detail found, exactly as on the dashboard. A miss is refunded, and a detail your account already holds is free. Paid plans only.

• linkedin_url The person's LinkedIn profile link (required). PitchWhip never opens it.
• want phone, email or both.
• name, company, title Who the person is. Needed when PitchWhip doesn't hold them yet: first and last name, and the company.

{ "linkedin_url": "https://www.linkedin.com/in/pat-lee", "want": "phone", "name": "Pat Lee", "company": "Northwind Care" }

{ "id": "rv_…", "status": "pending", "reveals_used": 1 }

People who asked PitchWhip not to contact them, and anyone on your team's do-not-contact or do-not-call lists, never come back with a detail.

Most reveals finish within a minute or two. Call this until status is done or failed.

Cost. Free.

{ "status": "done", "phone": "+44 …", "reveals_used": 1 }

status is pending, done or failed; an id that isn't yours is 404 with status not_found. A detail that wasn't found is simply missing.

Method POST

URL https://api.pitchwhip.com/v1/api/opener

Headers Authorization: Bearer {{your key}}

{
  "name": "/Full Name",
  "company": "/Company Name",
  "title": "/Job Title"
}

Fields to return: call_opener, email_opener.

Method POST

URL https://api.pitchwhip.com/v1/api/buyer

Headers Authorization: Bearer {{your key}}

{
  "company_domain": "/Company Domain",
  "role_hint": "Head of Operations"
}

Fields to return: buyers (status, and id when pending).

Method POST

URL https://api.pitchwhip.com/v1/api/reveal

Headers Authorization: Bearer {{your key}}

{
  "linkedin_url": "/LinkedIn Profile",
  "name": "/Full Name",
  "company": "/Company Name",
  "want": "both"
}

Fields to return: id.

Method GET

URL https://api.pitchwhip.com/v1/api/reveal/

Headers Authorization: Bearer {{your key}}

After the last slash of the URL, type / and pick the column holding the id from Start a reveal. Run it a few minutes after the reveal started, or again while status is pending.

Fields to return: status, phone, email.