A company groups customers who work together. People in the same company can see each other's private discussions, and can be emailed about all of them. With the API you can list your companies, look one up and add new ones; you put people in a company through the Users API.
Companies are part of some plans only. If yours doesn't include them, every request here is refused with a 401, as if the token were missing. You can check your plan under Account & Settings › Plans & Billing.
Examples use your token in $TENDER_TOKEN (see Authentication).
List companies
curl -H "Accept: application/vnd.tender-v1+json" \
-H "Authorization: Bearer $TENDER_TOKEN" \
https://api.tenderapp.com/yoursite/companies
{
"companies": [
{
"id": 3,
"name": "Brightline Studio",
"created_at": "2026-10-09T06:47:10Z",
"updated_at": "2026-10-09T06:47:24Z",
"permalink": "brightlinestudio",
"notifications_default": true,
"counter": 2,
"href": "https://api.tenderapp.com/yoursite/companies/3"
},
{
"id": 4,
"name": "Harbor & Pine",
"created_at": "2026-10-09T06:47:10Z",
"updated_at": "2026-10-09T06:47:24Z",
"permalink": "harborpine",
"notifications_default": true,
"counter": 2,
"href": "https://api.tenderapp.com/yoursite/companies/4"
}
],
"offset": 0,
"total": 3,
"per_page": 30
}
Companies come 30 to a page, in alphabetical order; ask for the next with ?page=2.
Get one company
curl -H "Accept: application/vnd.tender-v1+json" \
-H "Authorization: Bearer $TENDER_TOKEN" \
https://api.tenderapp.com/yoursite/companies/4
{
"id": 4,
"name": "Harbor & Pine",
"created_at": "2026-10-09T06:47:10Z",
"updated_at": "2026-10-09T06:47:24Z",
"permalink": "harborpine",
"notifications_default": true,
"counter": 2,
"href": "https://api.tenderapp.com/yoursite/companies/4"
}
Company fields
| Field | What it is |
|---|---|
id |
The company's id. Use it as a user's company_id. |
name |
The company's name. Unique on your site. |
permalink |
The name as used in the company's web address, made from the name. |
counter |
How many people are in the company. |
notifications_default |
Whether the company's people are emailed about all its discussions unless they turn it off themselves (true), or only if they turn it on (false). Change it on the company's page on your site. |
created_at, updated_at |
When the company was added and last changed. |
href |
This company in the API. |
Create a company
POST a name. You can also send the company's website as url; Tender keeps it but doesn't show it in the API.
curl -H "Accept: application/vnd.tender-v1+json" \
-H "Authorization: Bearer $TENDER_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Copperleaf Foods","url":"https://copperleaf.example.com"}' \
https://api.tenderapp.com/yoursite/companies
HTTP/1.1 201 Created
Location: http://api.tenderapp.com/yoursite/companies/5
{
"id": 5,
"name": "Copperleaf Foods",
"created_at": "2026-10-09T07:17:21Z",
"updated_at": "2026-10-09T07:17:21Z",
"permalink": "copperleaffoods",
"notifications_default": true,
"counter": 0,
"href": "https://api.tenderapp.com/yoursite/companies/5"
}
A name that's already taken gets a 422:
{
"name": ["has already been taken"]
}
The API can't rename or delete a company: do that from your site's dashboard.
Add people to a company
Set the user's company_id with the Users API, when you create them or later:
curl -X PUT \
-H "Accept: application/vnd.tender-v1+json" \
-H "Authorization: Bearer $TENDER_TOKEN" \
-H "Content-Type: application/json" \
-d '{"company_id":5}' \
https://api.tenderapp.com/yoursite/users/20
"company_id": null takes them out of their company.