---
source_url: https://www.pubnub.com/docs/admin-api/create-a-new-customer
title: Create a new customer
---

# Create a new customer

> For AI agents: documentation index at https://www.pubnub.com/llms-full.txt

Creates a new OEM customer record in your partner account.

**Best practices:**

* Use your own customer/tenant ID as the `externalId` for easy cross-referencing
* The `externalId` must be unique across your account
* You can assign keysets during creation or add them later via the assign keysets endpoint

## Request

Example

```
{
  "result": {
    "id": "string",
    "externalId": "string",
    "name": "string",
    "created": "string",
    "updated": "string",
    "keysets": [
      {
        "id": 0,
        "assignedAt": "string"
      }
    ]
  }
}
```

Example

```
{
  "statusCode": 0,
  "error": "BadRequest",
  "message": [
    "string"
  ]
}
```

Example

```
{
  "statusCode": 0,
  "error": "Unauthorized",
  "message": [
    "string"
  ]
}
```

Example

```
{
  "statusCode": 0,
  "error": "Forbidden",
  "message": [
    "string"
  ]
}
```

Example

```
{
  "statusCode": 0,
  "error": "InternalError",
  "message": [
    "string"
  ]
}
```