memberships > Memberships

Create Membership

Use this endpoint to create a new membership.

post/{tenant}/{environment}/{company}/membership

Request

tenantstring required

Your Entra Tenant ID. More details.

environmentstring required

Your Business Central Environment. More details.

companystring required

Your Business Central Company. More details.

x-api-versionstring date

Used for API versioning. More details.

itemNumberstring required

Unique identifier for an item.

activationDatestring date

The date from which the membership should be active. Setup can dictate and override this date.

companyNamestring

The name of the company associated with the membership.

preassignedCustomerNumberstring

A preassigned customer number for the membership. When there is no customer number, the system will generate one.

documentNostring

External identifier for the sales document.

Response with status 201

Sep 17, 202648cacf22ffcd Revision changes
- breaking
  added the new required request property
- breaking
  the request's body type changed from no type to object
- breaking
  the response's body type changed from no type to object for status
- warning
  deleted the header request parameter x-np-api-key
- info
  the endpoint scheme security NPApiKeyAuthScheme was added to the API
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the required property to the response with the status
Sep 12, 2026407697660280 Revision changes
- info
  api operation id create-membership removed and replaced with memberships_serviceMembership_createMembership