---
descriptions:
  create_organization_api_key:
    organization_id: The ID of the organization to create the API key for.
    name: A human-readable name for the API key.
    permissions: An optional array of permission strings to assign to the API key.
reference:
  curl:
    - key: create_organization_api_key
      id: create_organization_api_key
      url: /reference/authkit/api-keys/create-for-organization
      title: '/organizations/:id/api_keys'
      type: POST
      parameters:
        - key: organization_id
          type: string
          description: (create_organization_api_key.organization_id)
        - key: name
          type: string
          description: (create_organization_api_key.name)
        - key: permissions
          type: array
          optional: true
          description: (create_organization_api_key.permissions)
      returns:
        - (api_key)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/authkit/api-keys/create-for-organization.mdx
---

## Create organization API key

Creates a new API key for the specified organization. The response includes the full API key value, which is only returned once at creation time. Make sure to store this value securely as it cannot be retrieved again.

You can optionally specify permissions to control what actions the API key can perform. If no permissions are provided, the key will have no specific permissions assigned.

<CodeBlock referenceId="create_organization_api_key">
  <CodeBlockTab title="Request" file="create-organization-api-key" />
  <CodeBlockTab title="Response" file="create-organization-api-key-response" />
</CodeBlock>