Create company
Create a parent company under the authenticated client. A company groups organisations that belong to the same multi-site business, so that bills addressed to the group rather than to a specific site can be received and then routed to the right organisation. Companies are optional: organisations that are not part of a group need one.
Authentication. An API key (x-dolfin-api-key) or a JWT Bearer token. When your credential grants access to more than one client, select one with the x-dolfin-client-id header.
Authorizations
An API key issued to your client. It carries the client's scope; org-scoped calls also require the x-dolfin-organisation-id header. Keys are created and revoked by a client administrator.
Headers
Target client. Required when your credential grants access to more than one client; omit when it resolves a single client.
Body
Display name of the parent group, e.g. "Ozone Coffee".
Head office address line 1. Supplying the head office address lets Dolfin recognise group-level bills delivered there and hold them for manual routing instead of assigning them to whichever site shares the address.
ISO 3166-1 alpha-2 country code (e.g. GB, US, DE)
Contact address for notifications about bills awaiting routing.
Response
Created
Display name of the parent group, e.g. "Ozone Coffee".
Head office address. Used to recognise group-level bills, which are never routed automatically to an individual site.
ISO 3166-1 alpha-2 country code (e.g. GB, US, DE)
Contact address for notifications about bills awaiting routing.
Overrides the client-wide automatic-routing score for this company only. Null means the client setting applies. Useful when one group's bills carry messier addresses than the rest.
Overrides the client-wide automatic-routing margin for this company only. Null means the client setting applies.