> ## Documentation Index > Fetch the complete documentation index at: https://partner-help.letsdothis.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a membership billing portal session > Creates a short-lived billing portal session for the policy. The caller must authorize its logged-in member to the policy before invoking this endpoint. Each call returns a new session, so a request can be repeated safely. returnUrl must use HTTPS and isn't checked against your domains, so send only your own return URLs and never forward one from your client. Redirect the member to url straight away and don't log or store it. Returns 409 MEMBERSHIP_BILLING_UNAVAILABLE when the policy has no billing customer, 409 MEMBERSHIP_PORTAL_CONFIGURATION_REQUIRED when the organizer's billing portal isn't set up yet, and 503 MEMBERSHIP_BILLING_UNAVAILABLE when billing is temporarily unreachable; retry a 503 with backoff. > [!NOTE] > > This endpoint is in beta: its request and response contract can still change while it's being developed. ## OpenAPI ````yaml /openapi.json post /v0/membership-policies/{policyId}/billing-portal-session openapi: 3.1.0 info: title: Let's Do This API version: 0.1.0 description: > The full reference — getting started, pagination, error responses, rate limits and the changelog — lives at [partner-help.letsdothis.com/api-reference](https://partner-help.letsdothis.com/api-reference/overview). This page is the interactive OpenAPI view of the same specification. # Authentication Create an API key from **Settings** → **Credentials** in your Let's Do This account and send it as a bearer token: ```bash curl --request GET \ --url "https://api.letsdothis.com/v0/participants" \ --header "Authorization: Bearer YOUR-API-KEY" ``` Keep the key secret: it identifies your organization, so do not ship it in a website or native app. If a key is exposed, revoke it from the same section and create a replacement. # OpenAPI schema Download the [OpenAPI schema](https://api.letsdothis.com/documentation/json) to use with Postman or an OpenAPI client generator. servers: - url: https://api.letsdothis.com description: Production - url: https://api.staging.letsdothis.com description: Staging security: - bearerAuth: [] tags: - name: Events x-group: Events description: Events that participants can register for. - name: EventOccurrences x-group: Event occurrences description: >- Event occurrences scoped to the organizer associated with your Public API credentials. Unlike the public Events catalog, results are limited to your own events. - name: Races x-group: Races description: >- Races within an event occurrence. An event occurrence may have one or more races, for example a 5K and a 10K within the same race day. - name: Tickets x-group: Tickets description: Tickets that are available for events. - name: BookingForms x-group: Booking forms description: >- Booking forms define the questions a booker answers when registering for a ticket. A ticket usually references a single booking form, so expect zero or one, while a booking form may be shared across multiple tickets. - name: BookingFormFields x-group: Booking form fields description: >- Booking form fields are the individual questions on a booking form — their type, label, options, and whether an answer is required. A field can be reused across multiple forms. - name: Bookings x-group: Bookings description: >- Bookings are the transaction record for a registration. A booking may contain one or more participants (entries). - name: Membership x-group: Memberships description: >- Membership schemes, purchased policies and the memberships on them, owned by your organizer. Policies are billing contracts; a membership is one person on a policy. - name: Participant x-group: Participants description: Participants are users who successfully booked an event. - name: LineItem x-group: Line items description: Financial details related to individual items within transactions. - name: AddOns x-group: Add-ons description: >- Organizer-owned products that can be purchased and allocated to participants. Imported products retain stable external identities. - name: DiscountCodes x-group: Discount codes description: >- Discount codes participants enter at checkout to reduce the price of a booking. - name: Credits x-group: Credits description: >- Credits are balances participants can spend at checkout, identified by their email address. - name: Referrals x-group: Referrals description: >- Referral programs, the referrers registered on them, and asynchronous imports of historical referrals. - name: Application x-group: Applications description: >- Applications are created when a user applies for tickets that are set up to require an application process, such as balloted or "Good For Age" entries. - name: Partner x-group: Partners description: >- Partners that were created by the organization who can have Reserved Entries assigned to them. - name: ReservedEntries x-group: Reserved entries description: >- Reserved Entries are entries that are reserved for a partner. After being assigned, the partner can then allocate these entries to participants. - name: Timing x-group: Timing description: >- Timing providers push bib numbers and bib-pack shipments back to Let's Do This for the startlist entries they received. Available to select timing partners only. - name: Identity x-group: API key description: >- What your API key can reach. Available to every key, including scoped ones. paths: /v0/membership-policies/{policyId}/billing-portal-session: post: tags: - Membership summary: Create a membership billing portal session description: >- Creates a short-lived billing portal session for the policy. The caller must authorize its logged-in member to the policy before invoking this endpoint. Each call returns a new session, so a request can be repeated safely. returnUrl must use HTTPS and isn't checked against your domains, so send only your own return URLs and never forward one from your client. Redirect the member to url straight away and don't log or store it. Returns 409 MEMBERSHIP_BILLING_UNAVAILABLE when the policy has no billing customer, 409 MEMBERSHIP_PORTAL_CONFIGURATION_REQUIRED when the organizer's billing portal isn't set up yet, and 503 MEMBERSHIP_BILLING_UNAVAILABLE when billing is temporarily unreachable; retry a 503 with backoff. parameters: - schema: type: string pattern: ^[a-fA-F0-9]{24}$ in: path name: policyId required: true requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MembershipPortalSessionRequest' responses: '200': description: Default Response content: application/json: schema: $ref: '#/components/schemas/MembershipPortalSession' '400': description: Default Response content: application/json: schema: type: object required: - code - statusCode - message properties: code: type: string enum: - MEMBERSHIP_RESOURCE_NOT_FOUND - MEMBERSHIP_INVALID_REQUEST - MEMBERSHIP_PORTAL_CONFIGURATION_REQUIRED - MEMBERSHIP_BILLING_UNAVAILABLE - MEMBERSHIP_FROZEN - MEMBERSHIP_ALREADY_CANCELLED description: >- Stable error identifier. RESOURCE_NOT_FOUND covers missing and foreign resources alike. INVALID_REQUEST covers malformed input or fields that cannot be edited. PORTAL_CONFIGURATION_REQUIRED requires account setup; BILLING_UNAVAILABLE means billing cannot be resolved or reached. FROZEN and ALREADY_CANCELLED are reserved for future lifecycle writes. statusCode: type: integer message: type: string '404': description: Default Response content: application/json: schema: type: object required: - code - statusCode - message properties: code: type: string enum: - MEMBERSHIP_RESOURCE_NOT_FOUND - MEMBERSHIP_INVALID_REQUEST - MEMBERSHIP_PORTAL_CONFIGURATION_REQUIRED - MEMBERSHIP_BILLING_UNAVAILABLE - MEMBERSHIP_FROZEN - MEMBERSHIP_ALREADY_CANCELLED description: >- Stable error identifier. RESOURCE_NOT_FOUND covers missing and foreign resources alike. INVALID_REQUEST covers malformed input or fields that cannot be edited. PORTAL_CONFIGURATION_REQUIRED requires account setup; BILLING_UNAVAILABLE means billing cannot be resolved or reached. FROZEN and ALREADY_CANCELLED are reserved for future lifecycle writes. statusCode: type: integer message: type: string '409': description: Default Response content: application/json: schema: type: object required: - code - statusCode - message properties: code: type: string enum: - MEMBERSHIP_RESOURCE_NOT_FOUND - MEMBERSHIP_INVALID_REQUEST - MEMBERSHIP_PORTAL_CONFIGURATION_REQUIRED - MEMBERSHIP_BILLING_UNAVAILABLE - MEMBERSHIP_FROZEN - MEMBERSHIP_ALREADY_CANCELLED description: >- Stable error identifier. RESOURCE_NOT_FOUND covers missing and foreign resources alike. INVALID_REQUEST covers malformed input or fields that cannot be edited. PORTAL_CONFIGURATION_REQUIRED requires account setup; BILLING_UNAVAILABLE means billing cannot be resolved or reached. FROZEN and ALREADY_CANCELLED are reserved for future lifecycle writes. statusCode: type: integer message: type: string '503': description: Default Response content: application/json: schema: type: object required: - code - statusCode - message properties: code: type: string enum: - MEMBERSHIP_RESOURCE_NOT_FOUND - MEMBERSHIP_INVALID_REQUEST - MEMBERSHIP_PORTAL_CONFIGURATION_REQUIRED - MEMBERSHIP_BILLING_UNAVAILABLE - MEMBERSHIP_FROZEN - MEMBERSHIP_ALREADY_CANCELLED description: >- Stable error identifier. RESOURCE_NOT_FOUND covers missing and foreign resources alike. INVALID_REQUEST covers malformed input or fields that cannot be edited. PORTAL_CONFIGURATION_REQUIRED requires account setup; BILLING_UNAVAILABLE means billing cannot be resolved or reached. FROZEN and ALREADY_CANCELLED are reserved for future lifecycle writes. statusCode: type: integer message: type: string components: schemas: MembershipPortalSessionRequest: title: MembershipPortalSessionRequest type: object properties: returnUrl: type: string required: - returnUrl additionalProperties: false MembershipPortalSession: title: MembershipPortalSession type: object properties: url: type: string required: - url additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.