API referenceCatalogContacts

Create contact

Creates a customer or supplier. The required kind field is preserved in the returned contact projection.

Endpoint: POST /v1/contacts
Authorization: Permission depends on the body `kind`: `customer` → `customers:manage`, `supplier` → `providers:manage`.
Environments: Production and sandbox
Idempotency: Required for safe retries.
Common next step: Create a CFDI draft

List contacts GET

Lists customers or suppliers, selected by the required kind query parameter.

Get contact GET

Returns one customer or supplier. The stored contact kind means callers do not repeat kind in the path or query.