Partner Tokens Bulk Endpoint

These instructions are for organisations who send post-show communications to their audiences and want to prompt them to leave a show-score.com review using partner tokens.

These instructions detail how to generate a bulk list of survey URLs.

If you use Dotdigital or Iterable, then you should follow those specific guides instead.

Pre requisites

Software to send comms to your customers
Show-Score API key
Show-Score show ID

Speak to your TTG/Show-Score account manager to obtain these details.

Both of these are distinct from TTG/Encore API keys and IDs.

Quick start

Endpoint: /api/v2/webhooks/partner_tokens/bulk_generate?show_id={SHOW_ID}&count={COUNT}

Max count available=500

Example request (using curl)

curl -X GET "https://www.show-score.com/api/v2/webhooks/partner_tokens/bulk_generate?show_id=2418&count=50" \
  -H "Authorization: Bearer <API_KEY>"

Example response

{
  "success": true,
  "count": 50,
  "show": {
    "id": 1,
    "title": "A Delicate Balance",
    "slug": "a-delicate-balance"
  },
  "tokens": [
    {
      "token": "<TOKEN_1>",
      "review_url": "https://www.show-score.com/broadway-shows/a-delicate-balance/review?token=<TOKEN_1>",
      "expires_at": "T11:59:40.724-04:00"
    },
    {
      "token": "<TOKEN_2>",
      "review_url": "https://www.show-score.com/broadway-shows/a-delicate-balance/review?token=<TOKEN_2>",
      "expires_at": "T11:59:40.724-04:00"
    },
    // ... 48 more tokens
  ]
}