sam|nord Developers
samnord.com
Organizations

POST /organizations

Create a new organization. The authenticated user must have permission to create organizations.

Query parameters

Name Type Required Description
with[] string[] no Include related resources in the response. Pass multiple values as separate query parameters (e.g., ?with[]=createdBy&with[]=updatedBy). One of: createdBy, updatedBy.

Request body

Required.

application/json

  • name string · required
  • businessId string · required
  • country string · required — ISO 3166-1 alpha-3 country code
{
    "name": "Acme AB",
    "businessId": "556123-4567",
    "country": "SWE"
}

Responses

Status Description
201 Organization created successfully
422 Validation error

Response 201 body

  • data object · required
  • meta object · required
{
    "data": {
        "id": "019222d4-1d93-7d47-a3c4-b547e009a0f7",
        "businessId": "556123-4567",
        "country": "SWE",
        "createdAt": "2024-06-30T19:00:00Z",
        "createdBy": {
            "id": "019222d9-d87d-7724-bba6-ba91503ea311",
            "firstName": "John",
            "lastName": "Doe"
        },
        "name": "Acme Corporation",
        "updatedAt": "2024-06-30T19:00:00Z",
        "updatedBy": {
            "id": "019222d9-d87d-7724-bba6-ba91503ea311",
            "firstName": "John",
            "lastName": "Doe"
        }
    },
    "meta": {
        "requestId": "019a3a60-6328-7075-8a41-76ff545ca5d3",
        "userId": "019a3a60-929c-7820-9b35-bf79a8bf83a6",
        "organizationId": "019a3a60-8175-7a68-88da-ecb4a7040b86"
    }
}