---
title: "Signup an Organization on behalf of a Customer"
method: POST
path: "/partner/v2/signup"
tags: ["Signup (partner/v2)"]
---

# Signup an Organization on behalf of a Customer

`POST /partner/v2/signup`

[![Early Access](https://img.shields.io/badge/Lifecycle%20Stage-Early%20Access-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy) [![Request Access To Partner v2](https://img.shields.io/badge/-Request%20Access%20To%20Partner%20v2-%23bc8540)](mailto:ccloud-api-access+partner-v2-early-access@confluent.io?subject=Request%20to%20join%20partner/v2%20API%20Early%20Access&body=I%E2%80%99d%20like%20to%20join%20the%20Confluent%20Cloud%20API%20Early%20Access%20for%20partner/v2%20to%20provide%20early%20feedback%21%20My%20Cloud%20Organization%20ID%20is%20%3Cretrieve%20from%20https%3A//confluent.cloud/settings/billing/payment%3E.)

Create an organization for a customer. You must pass in either an entitlement object reference (a url to 
a previously created entitlement) or entitlement details. If you pass in an entitlement object reference, we will link with the 
created entitlement. If you pass in the entitlement details, we will create the entitlement with the organization 
in a single transaction. If you pass in user details (email, given name, and family name), we will
create a user as well. If you do not pass in user details, you MUST call `/partner/v2/signup/activate`
with user details to complete signup.

## Query parameters

- `dry_run` boolean

## Request body

- PartnerSignupRequest — The partner signup request
  - `organization` object, required — `Organizations` objects represent an entire Confluent Cloud organization.
    - `api_version` 'partner/v2' — APIVersion defines the schema version of this representation of a resource.
    - `kind` 'Organization' — Kind defines the object this REST resource represents.
    - `id` string — ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object `kinds` or objects of the same `kind` within a different scope/namespace ("space").
    - `metadata` ObjectMeta — ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
      - `self` string, uri, required — Self is a Uniform Resource Locator (URL) at which an object can be addressed. This URL encodes the service location, API version, and other particulars necessary to locate the resource at a point in time
      - `resource_name` string, uri — Resource Name is a Uniform Resource Identifier (URI) that is globally unique across space and time. It is represented as a Confluent Resource Name
      - `created_at` string, date-time — The date and time at which this object was created. It is represented in RFC3339 format and is in UTC.
      - `updated_at` string, date-time — The date and time at which this object was last updated. It is represented in RFC3339 format and is in UTC.
      - `deleted_at` string, date-time — The date and time at which this object was (or will be) deleted. It is represented in RFC3339 format and is in UTC.
    - `name` string, required — The name of the organization
    - `sso_url` string, uri — The login URL for the customer to access Confluent Cloud
    - `sso_config` AzureSSOConfig, required
      - `kind` string, required
      - `tenant_id` string, required — The Azure AD tenant ID
  - `user` object
  - `entitlement` union, required
    - object — `Entitlement` objects represent metadata about a marketplace entitlement.
      - `api_version` 'partner/v2' — APIVersion defines the schema version of this representation of a resource.
      - `kind` 'Entitlement' — Kind defines the object this REST resource represents.
      - `id` string — ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object `kinds` or objects of the same `kind` within a different scope/namespace ("space").
      - `metadata` ObjectMeta — ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
        - `self` string, uri, required — Self is a Uniform Resource Locator (URL) at which an object can be addressed. This URL encodes the service location, API version, and other particulars necessary to locate the resource at a point in time
        - `resource_name` string, uri — Resource Name is a Uniform Resource Identifier (URI) that is globally unique across space and time. It is represented as a Confluent Resource Name
        - `created_at` string, date-time — The date and time at which this object was created. It is represented in RFC3339 format and is in UTC.
        - `updated_at` string, date-time — The date and time at which this object was last updated. It is represented in RFC3339 format and is in UTC.
        - `deleted_at` string, date-time — The date and time at which this object was (or will be) deleted. It is represented in RFC3339 format and is in UTC.
      - `external_id` string, required — The unique external ID of the entitlement (this should be unique to customer)
      - `name` string, required — The name of the entitlement
      - `plan_id` string, required — The plan ID the entitlement
      - `product_id` string, required — The product ID of the entitlement
      - `usage_reporting_id` string — The usage reporting ID of the entitlement (if usage reporting uses a different ID, otherwise, same as external_id)
      - `resource_id` string — The resource ID of the entitlement
      - `organization` object — The organization associated with this object.
        - `id` string, required — ID of the referred resource
        - `environment` string — Environment of the referred resource, if env-scoped
        - `related` string, uri, required — API URL for accessing or modifying the referred object
        - `resource_name` string, uri, required — CRN reference to the referred resource
        - `api_version` string — API group and version of the referred resource
        - `kind` string — Kind of the referred resource
    - object — ObjectReference provides information for you to locate the referred object
      - `id` string, required — ID of the referred resource
      - `environment` string — Environment of the referred resource, if env-scoped
      - `related` string, uri, required — API URL for accessing or modifying the referred object
      - `resource_name` string, uri, required — CRN reference to the referred resource
      - `api_version` string — API group and version of the referred resource
      - `kind` string — Kind of the referred resource

## Response `201`

Successful signup.

- PartnerSignupResponse — The partner signup response
  - `organization_id` string, required — The ID of the organization
  - `sso_url` string, uri, required — The login URL for the customer to access Confluent Cloud
  - `display_message` string — The display message contains useful information which is shown on the Marketplace UI to the customers.

## Other responses

- `400` — Bad Request
- `401` — The request lacks valid authentication credentials for this resource.
- `403` — The access credentials were considered insufficient to grant access
- `409` — The request is in conflict with the current server state
- `429` — Rate Limit Exceeded
- `500` — Oops, something went wrong!

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) · [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluent/confluent-cloud-apis/revisions/a6a73f98a698/schema)