---
descriptions:
  create_organization_role:
    slug: >-
      A unique key to reference the role within the organization. Must begin
      with `org-` and contain only lowercase letters, numbers, hyphens, and
      underscores.
    name: A descriptive name for the role.
    description: An optional description for the role.
reference:
  curl:
    - key: create_organization_role
      id: create_organization_role
      url: /reference/roles/organization-role/create
      title: '/authorization/organizations/:id/roles'
      type: POST
      parameters:
        - key: slug
          type: string
          description: (create_organization_role.slug)
        - key: name
          type: string
          description: (create_organization_role.name)
        - key: description
          type: string
          optional: true
          description: (create_organization_role.description)
      returns:
        - (organization_role)
  js:
    - key: createOrganizationRole
      id: create_organization_role
      url: /reference/roles/organization-role/create
      title: authorization.createOrganizationRole()
      parameters:
        - key: organizationId
          type: string
          description: The ID of the organization.
        - key: options
          type: object
          unwrap: true
          properties:
            - key: slug
              type: string
              description: (create_organization_role.slug)
            - key: name
              type: string
              description: (create_organization_role.name)
            - key: description
              type: string
              optional: true
              description: (create_organization_role.description)
      returns:
        - key: OrganizationRole
          description: (organization_role.self)
  python:
    - key: create_organization_role
      id: create_organization_role
      url: /reference/roles/organization-role/create
      title: authorization.create_organization_role()
      parameters:
        - key: organization_id
          type: str
          description: The ID of the organization.
        - key: slug
          type: str
          description: (create_organization_role.slug)
        - key: name
          type: str
          description: (create_organization_role.name)
        - key: description
          type: str
          optional: true
          description: (create_organization_role.description)
      returns:
        - key: OrganizationRole
          description: (organization_role.self)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/roles/organization-role/create.mdx
---

## Create an organization role

Create a new custom organization role. The role will be specific to the organization and can be assigned to organization memberships.

The `slug` must be unique within the organization, begin with `org-`, and contain only lowercase letters, numbers, hyphens, and underscores.

<Callout type="info">
  New roles are placed at the bottom of the organization's priority order.
</Callout>

<CodeBlock referenceId="create_organization_role">
  <CodeBlockTab title="Request" file="create-organization-role-request" />
  <CodeBlockTab title="Response" file="create-organization-role-response" />
</CodeBlock>