POST Accounts

Gebruik dit endpoint om nieuwe accounts aan te maken, zoals klanten, leveranciers en vervoerders.

Gebruikersniveau: Gevorderd

Endpoint

POST /v1/{scopeId}/accounts

Create-regels

• De API controleert server-side of de resource binnen de toegestane organization en branch valt.
• Alleen velden die expliciet zijn toegestaan mogen meegestuurd worden.
• Onbekende of niet-toegestane velden geven 400 invalid_create.
• organization_id en branch_id worden server-side gezet en mogen niet door de client bepaald worden.
• Bij het aanmaken van een account maakt de API ook automatisch een account_branches koppeling aan voor de branch uit de URL.

Toegestane createvelden

Voorbeeldrequest

curl -X POST "https://api.routix.com/v1/550e8400-e29b-41d4-a716-446655440000/accounts" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme Transport B.V.",
    "email": "[email protected]",
    "phone": "+31 20 123 4567",
    "account_type": "customer",
    "status": "active"
  }'

Voorbeeldresponse

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "company_name": "Acme Transport B.V.",
    "email": "[email protected]",
    "phone": "+31 20 123 4567",
    "account_type": "customer",
    "status": "active"
  },
  "version": "v1"
}

Foutresponse

{
  "error": "invalid_create",
  "error_description": "One or more fields are not allowed for creates on accounts"
}

Mogelijke foutcodes

• 400 invalid_request
• 400 invalid_create
• 400 create_failed
• 401 unauthorized
• 401 invalid_token
• 403 invalid_token_type
• 403 insufficient_scope
• 404 not_found
• 405 method_not_allowed

Gerelateerde pagina’s

• Accounts GET
• Accounts PATCH
• API calls en voorbeelden