Partner Tokens + Dotdigital

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

Pre requisites

• Dotdigital.com configured to send post-show comms to your audience
• 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.

Step 1: Create Webhook

• Login to dotdigital.com
• Go to Connect > Webhooks → NEW WEBHOOK
• Configure:
  • Name: "Show Score API Integration"
  • Base URL: https://show-score.com
  • Authentication: API Key
  • Key: X-Partner-API-Key
  • Value: [YOUR_API_KEY]
• Add to: Header
  • Endpoint: /api/v2/webhooks/partner_tokens/generate?show_id=TEMPLATE
  • Method: GET
• Test with a contact from your test list

Step 2: Build Program Flow

• Create program in Automation > Programs: Start → Webhook → Decision → Email (success) / Retry (failure)
• Configure Decision Node
• Success path (HTTP 200): Send email
• Failure path: Wait 5-10 min → Retry webhook → End
• Configure Email
• Select your existing email template
• Update button URL to:

  {{webhook.review_url}}

• Each contact gets a unique link (expires in 6 months)

Step 3: Copy for Each Show

• Automation > Programs → Select template → Copy program
• Update webhook endpoint with show ID: From: show_id=TEMPLATE To: show_id=[YOUR_SHOW_ID]
• Update email content for specific show
• Test with test contacts
• Activate
  

Step 4: Testing

Check that:

• Webhook calls API successfully
• Show ID correct
• Email displays review URL
• Test with multiple contacts (unique URLs per contact)

API responses

Success (200)

{
  "success": true,
  "review_url": "https://show-score.com/.../review?token=...",
  "expires_at": "2025-07-15T12:00:00Z"
}

Common Errors

401: Invalid API key

404: Show not found

429: Rate limit (200 req/min) - retry after delay

500: Server error - retry after delay

Troubleshooting

Webhook fails:

Check API key in headers

Verify show_id

Contact Show-Score team if persists

Email doesn't send:

Verify Decision node checks for HTTP 200

Check email template is active

Review URL blank:

Confirm button uses

{{webhook.review_url}}

Rate limit (429):

Stagger program activation times

Use retry logic with 5-10 min delay