Organization - Create

POST /v2/organizations

Create a new Organization.

Try it: https://sandbox.hyperswitch.io/v2/organizations

Example (cURL)

Create Organization (cURL)
curl --request POST \
  --url https://sandbox.hyperswitch.io/v2/organizations \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "organization_name": "organization_abc"
}
'

Success response (200)

{
  "id": "org_q98uSGAYbjEwqs0mJwnz",
  "modified_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "organization_name": "<string>",
  "organization_details": {},
  "metadata": {},
  "organization_type": "standard"
}

Authorizations

  • api-key (header, required)

Admin API keys allow you to perform privileged actions such as creating a merchant account and Connector account.

Request body (application/json)

  • organization_name (string, required) Name of the organization.

  • organization_details (object) Details about the organization.

  • metadata (object) Metadata is useful for storing additional, unstructured information on an object.

Response (200 — application/json)

Organization Created

Response fields:

  • id (string, required) The unique identifier for the Organization Required string length: 1 - 64 Example: "org_q98uSGAYbjEwqs0mJwnz"

  • modified_at (string<date-time>, required)

  • created_at (string<date-time>, required)

  • organization_name (string | null) Name of the Organization

  • organization_details (object) Details about the organization

  • metadata (object) Metadata is useful for storing additional, unstructured information on an object.

  • organization_type (enum) Available options: standard, platform

Suggest edits: https://github.com/juspay/hyperswitch/edit/main/api-reference/v2/organization/organization--create.mdx Raise issue: https://github.com/juspay/hyperswitch/issues/new?title=Issue%20on%20docs&body=Path:%20/v2/organization/organization--create

API docs homepage: https://api-reference.hyperswitch.io/

PreviousorganizationNextcustomers