---
updatedAt: 2026-08-16T12:05:23.000Z
agentTools:
  projectIndex: https://dev.xyte.io/llms.txt
---

# Create Organization

Create a new Organization tied to the Partner (based on the API Key used).

The response includes an API key for the newly created organization, which can be used immediately to authenticate against the [Organization API](https://dev.xyte.io/reference/organization).

**Request Body**

| Name                    | Type   | Required | Description                                                             |
| :---------------------- | :----- | :------- | :---------------------------------------------------------------------- |
| name                    | string | Yes      | Organization name (must be unique within the partner, case-insensitive) |
| admin\_contact\_email   | string | Yes      | Admin contact email address                                             |
| admin\_contact\_name    | string | Yes      | Admin contact full name                                                 |
| finance\_contact\_email | string | No       | Finance contact email address (defaults to `admin_contact_email`)       |
| finance\_contact\_name  | string | No       | Finance contact full name (defaults to `admin_contact_name`)            |

**Returned Data**

| Name        | Type     | Description                                                          |
| :---------- | :------- | :------------------------------------------------------------------- |
| id          | string   | Unique Organization ID                                               |
| name        | string   | Organization display name                                            |
| created\_at | datetime | Creation timestamp (ISO 8601)                                        |
| api\_key    | string   | Organization API key for authenticating against the Organization API |

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Device Service",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://{url}",
      "variables": {
        "url": {
          "default": "url"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "access_key": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization"
      }
    }
  },
  "security": [
    {
      "access_key": []
    }
  ],
  "paths": {
    "/core/v1/partner/organizations": {
      "post": {
        "summary": "Create Organization",
        "description": "",
        "operationId": "partner-create-organization",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "description": "Partner API key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "admin_contact_email",
                  "admin_contact_name"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Organization name (must be unique within the partner, case-insensitive)",
                    "example": "Acme Corp"
                  },
                  "admin_contact_email": {
                    "type": "string",
                    "description": "Admin contact email address",
                    "example": "admin@acme.com"
                  },
                  "admin_contact_name": {
                    "type": "string",
                    "description": "Admin contact full name",
                    "example": "Alice Smith"
                  },
                  "finance_contact_email": {
                    "type": "string",
                    "description": "Finance contact email address (defaults to admin_contact_email)",
                    "example": "finance@acme.com"
                  },
                  "finance_contact_name": {
                    "type": "string",
                    "description": "Finance contact full name (defaults to admin_contact_name)",
                    "example": "Bob Jones"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "- Success": {
                    "value": "{\n\t\"id\": \"a83e7a2e...\",\n\t\"name\": \"Acme Corp\",\n\t\"created_at\": \"2024-01-15T10:30:00Z\",\n\t\"api_key\": \"sk_live_abc123...\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "example": "a83e7a2e..."
                    },
                    "name": {
                      "type": "string",
                      "example": "Acme Corp"
                    },
                    "created_at": {
                      "type": "string",
                      "example": "2024-01-15T10:30:00Z"
                    },
                    "api_key": {
                      "type": "string",
                      "example": "sk_live_abc123..."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Name already exists": {
                    "value": "{\n    \"error\": \"Name already taken\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Name already taken"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Invalid API key": {
                    "value": "{\n    \"error\": \"Not authorized\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Not authorized"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "403",
            "content": {
              "application/json": {
                "examples": {
                  "Feature not enabled": {
                    "value": "{\n    \"error\": \"Forbidden\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Forbidden"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "422",
            "content": {
              "application/json": {
                "examples": {
                  "Missing required field": {
                    "value": "{\n    \"error\": \"Validation failed\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Validation failed"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```