Skip to main content
POST
/
organizations
Create Organization
curl --request POST \
  --url https://api-sandbox.stablesea.com/v1/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "name": "Acme Corporation",
  "contact": {
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Doe"
  }
}
'
{
  "data": {
    "id": "org_123456789abcdef",
    "name": "Acme Corporation",
    "contact": {
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Doe"
    },
    "status": {
      "current_status": "ACTIVE",
      "status_history": [
        {
          "status": "ACTIVE",
          "created_at": "2024-01-15T10:00:00Z"
        }
      ]
    },
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}
Creates a new organization in the system.

​
Common Headers

HeaderValueRequiredDescription
AuthorizationBearer <api-key>trueYour API key for authentication
Content-Typeapplication/jsontrueContent type of the request
Idempotency-Key<unique-uuid>trueUnique key to prevent duplicate operations

​
Body

​
name
string
required
The name of the organization
​
contact
object
required
Contact information for the organization
​
contact.email
string
required
Email address of the organization contact
​
contact.first_name
string
required
First name of the organization contact
​
contact.last_name
string
required
Last name of the organization contact

​
Response

{
  "data": {
    "id": "org_123456789abcdef",
    "name": "Acme Corporation",
    "contact": {
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Doe"
    },
    "status": {
      "current_status": "ACTIVE",
      "status_history": [
        {
          "status": "ACTIVE",
          "created_at": "2024-01-15T10:00:00Z"
        }
      ]
    },
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

Authorizations

​
Authorization
string
header
default:DEFAULT-TOKEN-HERE
required

Use your API key as the bearer token

Headers

​
Idempotency-Key
string
required

Unique key to prevent duplicate operations

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

Organization to create

​
name
string
required
Example:

"Acme Corporation"

​
contact
object
required

Response

201 - application/json

Organization created successfully

​
data
object