Getting Started

This guide will walk you through creating your first wallet card using the WalletWerk API.

Step 1: Create an API Key

Log in to your dashboard
Navigate to the Developer tab
Click Create API Key
Select the scopes you need (start with campaigns:read and campaigns:write)
Copy and securely store your API key
You'll only see it once!

Keep your API key secure. Never commit it to version control or expose it in client-side code.

Step 2: Make Your First Request

Test your API key by listing your campaigns:

GET

/campaigns

Required scope: campaigns:read

List all campaigns for your organization.

curl -X GET https://api.walletwerk.eu/api/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.walletwerk.eu/api/v1/campaigns', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.get(
    'https://api.walletwerk.eu/api/v1/campaigns',
    headers=headers
)

data = response.json()
print(data)

Step 3: Create Your First Campaign

Now let's create a campaign:

POST

/campaigns

Required scope: campaigns:write

Create a new campaign for your wallet card program.

Request Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Campaign name (e.g., "Summer Concert 2025")
`type`	string	Yes	Campaign type: `event`, `membership`, `coupon`, `access`, or `generic`
`date`	string	No	Event date (ISO 8601 format)
`startTime`	string	No	Event start time (HH:mm format)

curl -X POST https://api.walletwerk.eu/api/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Concert 2025",
    "type": "event",
    "date": "2025-07-15",
    "startTime": "19:00"
  }'

const response = await fetch('https://api.walletwerk.eu/api/v1/campaigns', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Summer Concert 2025',
    type: 'event',
    date: '2025-07-15',
    startTime: '19:00'
  })
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

data = {
    'name': 'Summer Concert 2025',
    'type': 'event',
    'date': '2025-07-15',
    'startTime': '19:00'
}

response = requests.post(
    'https://api.walletwerk.eu/api/v1/campaigns',
    headers=headers,
    json=data
)

result = response.json()
print(result)

Next Steps

Learn about Core Concepts to understand the data model
Explore the API Reference for complete endpoint documentation
Check out Examples for real-world workflows