SuppliersUpdate Supplier

Update Supplier

Updates the name of an existing supplier.

Rules:

  • The name field is required and cannot be empty.
  • You cannot update to a name already used by another supplier in the same company.

Use this endpoint to fix typos or update a supplier's legal name.

curl -X PUT "https://api-sandbox.contasimples.com/suppliers/v1/suppliers/16" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "name": "Updated Supplier LLC"
}'
{
  "id": 16,
  "name": "Updated Supplier LLC",
  "type": {
    "id": 1,
    "type": "CUSTOM"
  }
}
PUT
/suppliers/v1/suppliers/{id}
PUT
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}

Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}
path
idinteger
Required

Numeric supplier identifier — use the id field returned by GET /suppliers/v1/suppliers.

Format: int32
Content-Typestring
Required

The media type of the request body

Options: application/json
namestring
Required

New supplier name. Must be unique among your registered suppliers.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}

Path Parameters

idinteger
Required

Numeric supplier identifier — use the id field returned by GET /suppliers/v1/suppliers.

Example:
16

Body

application/json
namestring
Required

New supplier name. Must be unique among your registered suppliers.

Example:
Updated Supplier LLC

Responses

idinteger
Required

Numeric supplier identifier.

companyIdstring

Always returns the ID of the authenticated company.

namestring
Required

Supplier name.

typestring
Required

Supplier type. Indicates whether created by your company (CUSTOM) or platform-seeded (DEFAULT).