Skip to main content
POST
Create organization

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

include
string

String. Comma-separated list of optional data sections to include in the response. Accepted values: address, invoiceDetails, settings, design, partner.

Example:

"address,partner"

Body

application/json
name
string
required

Display name of the new organization. String with maximum length of 255 characters.

Maximum string length: 255
Example:

"Acme Corp"

externalSourceId
string | null

Caller-supplied identifier used to address this organization from an external system. Must be unique within the client application. Omit if not needed. String with maximum length of 255 characters.

Maximum string length: 255
vat
string | null

Organization registration number (VAT/company number). String with maximum length of 255 characters.

Maximum string length: 255
phone
string | null

Main phone number of the organization. String with maximum length of 255 characters.

Maximum string length: 255
supportAccessEndDate
string<date-time> | null

ISO 8601 timestamp until which Findity support staff has elevated access to this organization.

sendEventToExternalSystem
boolean | null

Whether events from this organization are sent to the external system.

countryCode
string | null

ISO 3166-1 alpha-2 country code for the organization's home country. Defaults to the template organization's country when omitted.

Example:

"SE"

accountingCountryCode
string | null

ISO 3166-1 alpha-2 country code used to configure accounting settings. Defaults to the template organization's value when omitted.

Example:

"SE"

templateOrganizationId
string | null

Internal ID or externalSourceId of a template organization to use as a configuration baseline. When omitted the default template for the client application is used.

Response

Created

id
string
required

Unique internal identifier of the organization. 32-character hex string. Read-only; assigned by the server on creation.

Pattern: ^[0-9a-fA-F]{32}$
name
string
required

Display name of the organization.

status
enum<string>
required

Lifecycle status of the organization.

Available options:
NORMAL,
NEW,
INCOMPLETE
dateCreated
string<date-time>
required

ISO 8601 timestamp of when the organization was created.

lastUpdated
string<date-time>
required

ISO 8601 timestamp of when the organization was last modified.

reportReviewOnPartner
boolean
required

Whether expense report review is delegated to partner level rather than handled within this organization.

sendEventToExternalSystemPartnerLevel
boolean
required

Whether events are forwarded to the external system at partner level (rather than organization level).

sendEventToExternalSystem
boolean
required

Whether events from this organization are sent to the external system.

externalSourceId
string | null

Caller-supplied identifier used to address this organization from an external system. Null when no external source ID has been set.

vat
string | null

Organization registration number (VAT/company number).

phone
string | null

Main phone number of the organization. Null when no phone number has been set.

type
enum<string>
read-only

What kind of organization this is. COMPANY is a real organization, TEMPLATE is a template organization usable as templateOrganizationId when creating one. Template organizations have no employees, partner or design, so design comes back empty and meta is left out for them.

Available options:
COMPANY,
TEMPLATE
clientApplicationId
string

ID of the client application (partner integration) that created this organization.

personId
string

ID of the person that administers this organization. When several persons are linked to the authenticated account, this is the specific person holding the administrator role for this organization, which is not necessarily the logged in person. Falls back to the logged in person when no separate person is found.

Pattern: ^[0-9a-fA-F]{32}$
automaticSetupEnabled
boolean | null

Whether the organization is set up automatically from its partner template. Always present, and null when the flag has never been set.

automaticSetupCompleted
boolean | null

Whether the automatic setup has finished. Always present, and null when the flag has never been set; a client that drives onboarding treats enabled and not completed as setup still pending.

supportAccessEndDate
string<date-time> | null

ISO 8601 timestamp until which Findity support staff has elevated access to this organization. Null when no support access window is active.

policyUrl
string | null

Pre-signed URL to the organization's active policy document. Null when no policy document is configured.

address
object | null

Postal address of the organization. Only present when include=address is requested. Null when the organization has no address on record.

invoiceDetails
object | null

Invoice address and billing contact. Only present when include=invoiceDetails is requested. Null when the organization has no invoice details on record.

settings
object

Organization-specific configuration settings. Only present when include=settings is requested. Empty object when the organization has no custom settings configured.

design
object

Branding and visual design configuration for this organization, resolved by merging client application, partner and organization level design. Only present when include=design is requested. Empty object when the organization has no custom design configured.

partner
object | null

Partner affiliation details. Only present when include=partner is requested. Null when the organization has no partner association.

meta
object

Additional computed data about the organization. Only present on GET /organizations when include=meta.permissions is requested. This is per-organization metadata and is unrelated to the list level meta object that carries count and total. The name follows the include=meta.* convention used across the Findity APIs, and matches the same field on GET /v1/expense/me/organizations. Left out for template organizations, which cannot have an employee and therefore no permissions to report.