---
title: "Signup a Customer by Linking to an Existing Organization"
method: POST
path: "/partner/v2/signup/link"
tags: ["Signup (partner/v2)"]
---

# Signup a Customer by Linking to an Existing Organization

`POST /partner/v2/signup/link`

[![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.)

Signup a customer by linking a new entitlement to an existing Confluent Cloud organization.

## Query parameters

- `dry_run` boolean

## Request body

- PartnerLinkRequest — The partner linking request
  - `token` string, required — The linking token that was generated.
  - `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 — 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
  - `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)