Create Member

Create a new member for a customer.

Only B2B customers with the member management feature enabled can add members. The authenticated user or organization must have access to the customer's organization.

Scopes: members:write

post/v1/customers/{id}/members

Request

Base URL
https://api.polar.sh
URL
https://api.polar.sh/v1/customers/{id}/members
Auth
- OpenID Connect (/.well-known/openid-configuration, scopes: members:write)
- or HTTP bearer
- or HTTP bearer

Path parameters

idstring uuid4 required

The customer ID.

Request body

emailstring email required

The email address of the member.

namestring nullable

The name of the member.

external_idstring nullable

The ID of the member in your system. This must be unique within the customer.

role'member' | 'billing_manager'

The role of the member within the customer. To assign or transfer ownership, use the member update endpoint.

Example request

{
  "email": "member@example.com",
  "name": "Jane Doe",
  "external_id": "usr_1337",
  "role": "member"
}

Response

Member created.

idstring uuid4 required

The ID of the member.

created_atstring date-time required

Creation timestamp of the object.

modified_atstring date-time nullable required

Last modification timestamp of the object.

customer_idstring uuid4 required

The ID of the customer this member belongs to.

emailstring required

The email address of the member.

namestring nullable required

The name of the member.

external_idstring nullable required

The ID of the member in your system. This must be unique within the customer.

role'owner' | 'billing_manager' | 'member' required

Example response

{
  "email": "member@example.com",
  "name": "Jane Doe",
  "external_id": "usr_1337"
}

Changes

No recorded changes to this operation across all 11 revisions of this API.