Skip to main content

​
Unlock event contacts access

Unlock event-level personnel and contact access for a specific event. Use this endpoint when preview-style access is no longer enough and you want full contact access for one event.

​
Endpoint

POST /external/events/:id/unlock

​
Authentication

See Authentication

​
Success status code

201 Created

​
Path parameters

NameRequiredTypeNotes
idYesstringEvent identifier.

​
Response example

{
  "success": true,
  "alreadyUnlocked": false,
  "creditsUsed": 2000,
  "balanceAfter": {
    "subscriptionBalance": 18000,
    "permanentBalance": 0,
    "totalBalance": 18000,
    "unlimited": false
  },
  "event": {
    "id": "123",
    "eventId": "139574",
    "name": "Shoptalk"
  }
}

​
Error responses

  • 400 Bad Request
  • 401 Unauthorized
  • 402 Payment Required
  • 404 Not Found
  • 409 Conflict

​
Notes

  • If the event is already unlocked, the response sets alreadyUnlocked to true and no additional credits are used.
  • The route returns 400 Bad Request when no additional contacts are available to unlock for the event.
  • Successful responses include the remaining credit balance and basic event details.