Create organisation

post

https://api.ekko.earth/v3/organisations

Create an organisation under a parent organisation.

Body Params

parentOrganisationId

uuid

required

Parent organisation ID.

tradingName

string

required

legalName

string

required

address

object

required

currencyCode

string

required

length between 3 and 3

ISO 4217 currency code

website

uri | null

billing

object | null

If omitted, ekko bills the nearest parent organisation up the organisation tree where billing is configured (this may be several levels above). If provided, include all required billing details for this organisation.

mcc

string | null

^[0-9]{4}$

Merchant Category Code (4 digits)

If your organisation has a consistent MCC, set it here. Then you can omit merchant details when creating an impact quote or SDK session.

relativeProfitShare

number | null

0 to 1

Defaults to 0

Relative profit share expressed as a decimal (for example, 0.6 = 60%). This is the organisation's percentage of the service fee passed down from its parent.

organisationReference

string | null

Optional metadata field for your own internal references, such as a merchant ID, account ID, or CRM identifier.

Headers

Ekko-Version

string

required

^\d{4}-\d{2}-\d{2}\.[a-z]+$

Defaults to 2026-10-06.pangolin

The API version the request was built against, as YYYY-MM-DD.animal. Required on every request. See Versioning.

Responses

Language

Credentials

Bearer

Loading…

Response

Choose an example:

application/json

201Organisation created

400Bad request

401Unauthorised

404Not found

409Conflict. The request conflicts with the current state of the resource.

422Unprocessable entity. The request was understood but cannot be processed as asked.

500Server error

503Service unavailable. The upstream service could not be reached, so the request was not performed.