Create Organization

Creates a new organization for onboarding via a partner integration.

Body Params
string
required
length ≤ 255

Legal entity name.

string
required
^[A-Z]{2}$

ISO 3166-1 alpha-2 country code.

string
required
^[A-Z]{3}$

ISO 4217 currency code.

billingAddress
object
required
string
required
length ≤ 128

Legal form of the entity. Must be a value from reference data (FR2).

string

VAT identification number.

string
required
length ≤ 64

Trade register number of the legal entity.

string

National register court. Required for DE only.

date
required

Foundation date of the legal entity in ISO 8601 format (YYYY-MM-DD). Must be in the past.

string
required
length ≤ 128

Your permanent reference ID for this organization (e.g. your internal business customer ID). Stored verbatim,
echoed back on all responses, and enforced as unique per partner — prevents logical duplicates across separate API calls.
Distinct from the Idempotency-Key header, which handles network-level retry safety.

metadata
object

Arbitrary key-value pairs for storing additional information on this Pliant object.
For your own use and reference.

leadData
object

Additional lead information used for sales qualification and CRM enrichment.

Headers
string
required
length between 16 and 256

An opaque, unique string that identifies this request — any sufficiently random value (e.g. a UUID) is acceptable. Re-delivery of the same key for the same operation is a no-op. Reusing a key with a different request body returns 409. Follows the IETF HTTP API Working Group's Idempotency-Key specification: https://github.com/ietf-wg-httpapi/idempotency

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Choose an example:
application/json