Complete Workflow: Create Campaign and Send Wallet Cards

This example shows the complete flow from creating a campaign to sending wallet cards to recipients. All code examples are ready to use — just replace YOUR_API_KEY with your actual API key.

Step 1: Create a Campaign

First, create a campaign that defines your wallet card program:

POST

/campaigns

Required scope: campaigns:write

Create a new campaign for your wallet card program.

curl -X POST https://api.walletwerk.eu/api/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech Conference 2025",
    "campaignType": "event",
    "campaignData": {
      "location": "San Francisco Convention Center",
      "address": "747 Howard St, San Francisco, CA 94103",
      "start_time": "09:00",
      "end_time": "18:00",
      "timezone": "America/Los_Angeles",
      "barcodeType": "qr",
      "barcodeValueStrategy": "auto"
    },
    "startDate": "2025-12-15",
    "endDate": "2025-12-17",
    "providerTypes": ["all"]
  }'

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://api.walletwerk.eu/api/v1';

async function createCampaign() {
  const response = await fetch(`${BASE_URL}/campaigns`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'Tech Conference 2025',
      campaignType: 'event',
      campaignData: {
        location: 'San Francisco Convention Center',
        address: '747 Howard St, San Francisco, CA 94103',
        start_time: '09:00',
        end_time: '18:00',
        timezone: 'America/Los_Angeles',
        barcodeType: 'qr',
        barcodeValueStrategy: 'auto'
      },
      startDate: '2025-12-15',
      endDate: '2025-12-17',
      providerTypes: ['all']
    })
  });

  if (!response.ok) {
    throw new Error(`Failed to create campaign: ${response.statusText}`);
  }

  const data = await response.json();
  return data.data.id; // Returns campaign ID
}

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://api.walletwerk.eu/api/v1'

def create_campaign():
    headers = {
        'Authorization': f'Bearer {API_KEY}',
        'Content-Type': 'application/json'
    }
    
    payload = {
        'name': 'Tech Conference 2025',
        'campaignType': 'event',
        'campaignData': {
            'location': 'San Francisco Convention Center',
            'address': '747 Howard St, San Francisco, CA 94103',
            'start_time': '09:00',
            'end_time': '18:00',
            'timezone': 'America/Los_Angeles',
            'barcodeType': 'qr',
            'barcodeValueStrategy': 'auto'
        },
        'startDate': '2025-12-15',
        'endDate': '2025-12-17',
        'providerTypes': ['all']
    }
    
    response = requests.post(
        f'{BASE_URL}/campaigns',
        headers=headers,
        json=payload
    )
    response.raise_for_status()
    data = response.json()
    return data['data']['id']  # Returns campaign ID

Step 2: Add a Recipient

Add a recipient to the campaign. This creates the recipient and wallet card, but does not send an invite:

POST

/campaigns/{campaignId}/recipients

Required scope: campaigns:write

Add a single recipient to a campaign. Wallet cards are automatically created in the background.

CAMPAIGN_ID="campaign_abc123"

curl -X POST https://api.walletwerk.eu/api/v1/campaigns/$CAMPAIGN_ID/recipients \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "attendee@example.com",
    "name": "Jane Doe",
    "recipientData": {
      "ticketNumber": "TICKET-001",
      "seatNumber": "A15"
    }
  }'

async function addRecipient(campaignId) {
  const response = await fetch(
    `${BASE_URL}/campaigns/${campaignId}/recipients`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        email: 'attendee@example.com',
        name: 'Jane Doe',
        recipientData: {
          ticketNumber: 'TICKET-001',
          seatNumber: 'A15'
        }
      })
    }
  );

  if (!response.ok) {
    throw new Error(`Failed to add recipient: ${response.statusText}`);
  }

  const data = await response.json();
  console.log('Recipient added:', data.data.id);
  return data.data;
}

def add_recipient(campaign_id):
    headers = {
        'Authorization': f'Bearer {API_KEY}',
        'Content-Type': 'application/json'
    }
    
    payload = {
        'email': 'attendee@example.com',
        'name': 'Jane Doe',
        'recipientData': {
            'ticketNumber': 'TICKET-001',
            'seatNumber': 'A15'
        }
    }
    
    response = requests.post(
        f'{BASE_URL}/campaigns/{campaign_id}/recipients',
        headers=headers,
        json=payload
    )
    response.raise_for_status()
    data = response.json()
    print(f"Recipient added: {data['data']['id']}")
    return data['data']

Step 3: Invite Recipient

After adding a recipient, invite them to add the wallet card to their device. This updates their status to invited and optionally sends an email:

POST

/campaigns/{campaignId}/recipients/{recipientId}/invite

Required scope: campaigns:write

Send an invite to a recipient. This updates their status to invited and optionally sends an email.

CAMPAIGN_ID="campaign_abc123"
RECIPIENT_ID="recipient_xyz789"

curl -X POST https://api.walletwerk.eu/api/v1/campaigns/$CAMPAIGN_ID/recipients/$RECIPIENT_ID/invite \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sendEmail": true
  }'

async function inviteRecipient(campaignId, recipientId) {
  const response = await fetch(
    `${BASE_URL}/campaigns/${campaignId}/recipients/${recipientId}/invite`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        sendEmail: true
      })
    }
  );

  if (!response.ok) {
    throw new Error(`Failed to invite recipient: ${response.statusText}`);
  }

  const data = await response.json();
  console.log('Recipient invited:', data.data.id);
  console.log('Download URL:', data.data.downloadUrl);
  return data.data;
}

def invite_recipient(campaign_id, recipient_id):
    headers = {
        'Authorization': f'Bearer {API_KEY}',
        'Content-Type': 'application/json'
    }
    
    payload = {
        'sendEmail': True
    }
    
    response = requests.post(
        f'{BASE_URL}/campaigns/{campaign_id}/recipients/{recipient_id}/invite',
        headers=headers,
        json=payload
    )
    response.raise_for_status()
    data = response.json()
    print(f"Recipient invited: {data['data']['id']}")
    print(f"Download URL: {data['data'].get('downloadUrl', 'N/A')}")
    return data['data']

Step 4: Complete Workflow Function

Here's a complete function that ties everything together:

async function createCampaignAndInviteRecipient() {
  try {
    // Step 1: Create a campaign
    const campaignId = await createCampaign();
    console.log('Campaign created:', campaignId);

    // Step 2: Add a recipient
    const recipient = await addRecipient(campaignId);
    console.log('Recipient added:', recipient.id);

    // Step 3: Invite the recipient
    const invited = await inviteRecipient(campaignId, recipient.id);
    console.log('Recipient invited:', invited.id);
    console.log('Download URL:', invited.downloadUrl);

    return { campaignId, recipientId: recipient.id, downloadUrl: invited.downloadUrl };
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}

// Run the function
createCampaignAndInviteRecipient();

def create_campaign_and_invite_recipient():
    try:
        # Step 1: Create a campaign
        campaign_id = create_campaign()
        print(f'Campaign created: {campaign_id}')

        # Step 2: Add a recipient
        recipient = add_recipient(campaign_id)
        print(f"Recipient added: {recipient['id']}")

        # Step 3: Invite the recipient
        invited = invite_recipient(campaign_id, recipient['id'])
        print(f"Recipient invited: {invited['id']}")
        print(f"Download URL: {invited.get('downloadUrl', 'N/A')}")

        return {
            'campaign_id': campaign_id,
            'recipient_id': recipient['id'],
            'download_url': invited.get('downloadUrl')
        }
    except requests.exceptions.RequestException as e:
        print(f'Error: {e}')
        raise

# Run the function
if __name__ == '__main__':
    create_campaign_and_invite_recipient()

Next Steps

Learn about bulk operations for adding multiple recipients
Set up webhooks to receive real-time status updates
Explore push notifications to send updates to active cards
Review best practices for production deployments