Skip to main content
POST
/
apps
/
{client_id}
/
production-tests
curl -X POST \
  -H "Authorization: Bearer sk_workspace_test_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"BankID SE Test","providerIds":["bankidse"],"maxStamps":3}' \
  "https://sandbox.api.hopae.com/connect/v1/apps/abc123/production-tests"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "hostClientId": "abc123",
  "hostName": "My App",
  "title": "BankID SE Test",
  "description": null,
  "providerIds": ["bankidse"],
  "targetPlatform": null,
  "maxStamps": 3,
  "currentStampCount": 0,
  "isActive": true,
  "allowDuplicateParticipation": false,
  "expiresAt": "2025-02-15T23:59:59.000Z",
  "createdAt": "2025-01-15T10:00:00.000Z",
  "updatedAt": "2025-01-15T10:00:00.000Z"
}
Creates a new production test challenge. The app name is automatically used as the host name. Provider IDs are validated against eligibility criteria.

​
Request

​
Authorization
string
required
Bearer <API_KEY> from Console > Developers > Workspace API Keys.
​
Content-Type
string
application/json

​
Path parameters

​
client_id
string
required
Client identifier of the app.

​
Request body

​
title
string
required
Challenge title (max 200 characters).
​
description
string
Challenge description (max 1000 characters).
​
providerIds
string[]
Provider IDs to test. Each provider must be:
  • Registered in the system
  • Enabled for the app (app.providers configuration)
  • Not a chip-based provider (type 2)
  • Available in the current deployment environment
If omitted, all eligible providers are included.
​
targetPlatform
string
Target platform filter: ios or android.
​
maxStamps
number
Maximum number of stamps (first-come limit). Minimum 1, default 3.
​
allowDuplicateParticipation
boolean
Whether to allow the same user to participate multiple times with the same provider. Default false.

​
Response

Returns the created challenge object.
​
id
string
Challenge ID.
​
title
string
Challenge title.
​
currentStampCount
number
Current stamp count (starts at 0).
​
isActive
boolean
Whether the challenge is active.
curl -X POST \
  -H "Authorization: Bearer sk_workspace_test_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"BankID SE Test","providerIds":["bankidse"],"maxStamps":3}' \
  "https://sandbox.api.hopae.com/connect/v1/apps/abc123/production-tests"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "hostClientId": "abc123",
  "hostName": "My App",
  "title": "BankID SE Test",
  "description": null,
  "providerIds": ["bankidse"],
  "targetPlatform": null,
  "maxStamps": 3,
  "currentStampCount": 0,
  "isActive": true,
  "allowDuplicateParticipation": false,
  "expiresAt": "2025-02-15T23:59:59.000Z",
  "createdAt": "2025-01-15T10:00:00.000Z",
  "updatedAt": "2025-01-15T10:00:00.000Z"
}