Add a Buyer

POST /buyers

Api key auth

Add a new buyer. A user is also created and invitation email is sent to the buyer.

application/json

Body

buyer object
Hide buyer attributes Show buyer attributes object
- email Required
- full_name Required
- company_name Required
- company_ein string
- phone string(phone)
- address1 string
- address2 string
- city string
- state string
- zip string
- country string
- website string
- price_list_id string(guid)
  
  Price List ID
- account_manager_id string(guid)
  
  Account Manager ID

Responses

201 application/json

Buyer created
Hide response attributes Show response attributes object
- id string(guid)
  
  System generated unique identifier. Don't include this in POST request body.
- company_name string
- company_ein string
- email string(email)
- phone string(phone)
- address1 string
- address2 string
- city string
- state string
- zip string
- country string
- website string
- price_list_id string(guid)
  
  Price List ID
- account_manager_id string(guid)
  
  Account Manager ID
- created_at string(date-time)
- updated_at string(date-time)

POST /buyers

curl \
 --request POST 'https://stg.getfoundation.com/api/external/v1/buyers' \
 --header "X-API-Key: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"buyer":{"company_name":"Acme Corp","company_ein":"11-23456789","phone":"+1 123 456 7890","address1":"string","address2":"string","city":"string","state":"string","zip":"string","country":"string","website":"string","price_list_id":"string","account_manager_id":"string"}}'

Request examples

{
  "buyer": {
    "company_name": "Acme Corp",
    "company_ein": "11-23456789",
    "phone": "+1 123 456 7890",
    "address1": "string",
    "address2": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "country": "string",
    "website": "string",
    "price_list_id": "string",
    "account_manager_id": "string"
  }
}

Response examples (201)

{
  "id": "9aa62446-c3b0-42f5-8027-3648daed9d73",
  "company_name": "Acme Corp",
  "company_ein": "11-23456789",
  "email": "hello@example.com",
  "phone": "+1 123 456 7890",
  "address1": "string",
  "address2": "string",
  "city": "string",
  "state": "string",
  "zip": "string",
  "country": "string",
  "website": "string",
  "price_list_id": "string",
  "account_manager_id": "string",
  "created_at": "2025-05-04T09:42:00Z",
  "updated_at": "2025-05-04T09:42:00Z"
}