Create a company
Add a company together with at least one person who works there.
POST
/api/v1/leadsScope
leads:writeAdds a company and the people at it in one call. Each person is either someone new, by email, or an existing contact without a company, by id. New people become contacts linked to the company.
Body
Send a JSON object.
Prop
Type
Example request
curl -X POST "https://api.pedibee.com/api/v1/leads" \
-H "Authorization: Bearer $PEDIBEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"companyName": "Northwind",
"domain": "northwind.io",
"industry": "Software",
"tier": "HOT",
"contacts": [
{
"email": "jane@northwind.io",
"name": "Jane Cooper",
"title": "CTO"
},
{
"contactId": "66f1c2a9e4b0a1b2c3d4e5f7"
}
]
}'Response
The new company.
{
"id": "66f1c2a9e4b0a1b2c3d4e001",
"companyName": "Northwind",
"domain": "northwind.io",
"industry": "Software",
"tier": "HOT",
"lifecycleStage": "NEW",
"notes": null,
"source": "MANUAL",
"createdAt": "2026-10-05T09:30:00.000Z",
"updatedAt": "2026-10-05T09:30:00.000Z"
}Errors
Every error is { "error": "…" } with a message you can show. See Errors and limits.
| Status | When |
|---|---|
400 | A required field is missing, contacts is empty or has more than 50 people, an email is invalid or listed twice, or a person already belongs to another company. |
403 | The key doesn’t have leads:write, or its creator’s role no longer allows it. |
404 | A contactId isn't a contact in your workspace. |
409 | A company with this domain already exists. The message names it. |
401 | The API key is missing, invalid, revoked or expired. |
429 | Too many requests. Wait for the seconds in Retry-After. |