> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bm.cards/llms.txt
> Use this file to discover all available pages before exploring further.

# Issue a wallet card for a brand activation

> Issues a wallet pass tied to an existing brand activation. Send cardholder and pass data in the request body after the activation is created.



## OpenAPI

````yaml /openapi/brand-api.json post /{brand_id}/brand-activations/{brand_activation_external_identifier}/issue-wallet
openapi: 3.0.0
info:
  title: Bambu Brand API
  description: >-
    Partner APIs for issuing and managing wallet cards, activations,
    transactions, SMS, and program configuration. Start with the Guides tab for
    authentication and your first issue-wallet call.
  version: 1.0.0
servers:
  - url: https://api.bambumeta.software/brands
    description: Production
  - url: https://api-sandbox.bambumeta.software/brands
    description: Sandbox
security: []
tags:
  - name: brand
    description: Brand setup and configuration
  - name: brand-activation
    description: Onboarding activations and issue-wallet for an activation
  - name: brands
    description: Custom brand attribute fields
  - name: link-activation
    description: Distribution link activation CRUD
  - name: onboarding
    description: >-
      Program onboarding metrics (internal tag, grouped under reporting in the
      portal)
  - name: program
    description: Program setup and transactions
  - name: reporting
    description: Pass and stage breakdown reports
  - name: sms
    description: Send outbound SMS messages
  - name: subscription
    description: SMS subscription enrollment and stage updates
  - name: template
    description: Wallet template management
  - name: transactions
    description: Transaction types, records, and program transactions
  - name: wallet
    description: Issue, retrieve, update, and delete wallet cards
  - name: wallet-bulk
    description: Bulk pass updates and scheduled changes
  - name: workflow
    description: Trigger workflows that issue or update passes
paths:
  /{brand_id}/brand-activations/{brand_activation_external_identifier}/issue-wallet:
    post:
      tags:
        - brand-activation
      summary: Issue a wallet card for a brand activation
      description: >-
        Issues a wallet pass tied to an existing brand activation. Send
        cardholder and pass data in the request body after the activation is
        created.
      parameters:
        - name: brand_activation_external_identifier
          in: path
          required: true
          description: Unique identifier for the brand activation
          schema:
            type: string
          example: signup-spring-2026
        - name: brand_id
          in: path
          required: true
          description: Unique identifier for the brand
          schema:
            type: string
          example: '353'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                formData:
                  type: object
                  description: attributes of the wallet to be issued
            example:
              person:
                firstName: Alex
                lastName: Member
                email: member@example.com
                phone: '+15551234567'
              passdata:
                points: 0
                metaData:
                  memberId: '1001'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema: {}
              example:
                passId: 12345
                serialNumber: 88faf0d9-196c-11f1-99ef-0e0d839580d9
                templateId: 100
                personId: 550e8400-e29b-41d4-a716-446655440000
                passdata:
                  points: 0
                  metaData:
                    memberId: '1001'
                downloadUrl: >-
                  https://wallet-pass.bambumeta.software/brand/353/88faf0d9-196c-11f1-99ef-0e0d839580d9
                downloadUrlApple: >-
                  https://wallet-pass.bambumeta.software/brand/353/88faf0d9-196c-11f1-99ef-0e0d839580d9
                downloadUrlGoogle: https://pay.google.com/gp/v/save/eyJhbGciOiJFUzI1NiJ9...
                statusCode: ACTIVE
                status: 200
      security:
        - cognito-authorizer: []
components:
  securitySchemes:
    cognito-authorizer:
      type: apiKey
      name: Authorization
      in: header

````