Create or Update Platform Profile

POST /reservation/api/1/platform/{platform-code}/profile

Create or update details for external reservation platform.

Path parameters

  • platform-code string Required

    The unique code assigned to the reservation platform.

    Maximum length is 11. Format should match the following pattern: [a-zA-Z0-9_-]+.

application/json

Body

Responses

  • 200

    Accepted

  • 400

    Non relevant request

  • 403

    Scope 'reservation-{platform-code}' not found in the token

POST /reservation/api/1/platform/{platform-code}/profile
curl \
 -X POST https://api.lsk.lightspeed.app/reservation/api/1/platform/MyPlatform/profile \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"baseUrl":"https://my.platform/api","orderWebhookUrl":"https://my.platform/api/webhook/orders","integrationWebhookUrl":"https://my.platform/api/webhook/integrations","onboardingWebhookUrl":"https://my.platform/api/webhook/onboarding","errorsWebhookUrl":"https://my.platform/api/webhook/errors","notificationTypes":["ORDER_CLOSED"],"displayName":"My Platform","depositSupported":true,"ownNotificationsOnly":true,"webhookAuthType":"OAUTH2","webhookAuthDetails":{"basic":{"username":"LightspeedKSeries","password":"Example-Password"},"bearer":{"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","tokenTtl":"2025-01-01T00:00:00"},"apiKeys":{"headers":{"X-API-ID":"Example-x-api-id","X-API-SECRET":"Example-x-api-secret"},"parameters":{"key":"string"}},"oauth2":{"clientId":"LightspeedKSeries","clientSecret":"Example-Client-Secret","clientName":"LightspeedKSeries","clientAuthorizationMethod":"CLIENT_SECRET_BASIC","authorizationGrantType":"CLIENT_CREDENTIALS","scopes":["webhooks-api"],"providerTokenUri":"https://my.platform/emitter/token","providerJwkSetUri":"https://my.platform/public-keys"}}}'
Request example
{
  "baseUrl": "https://my.platform/api",
  "orderWebhookUrl": "https://my.platform/api/webhook/orders",
  "integrationWebhookUrl": "https://my.platform/api/webhook/integrations",
  "onboardingWebhookUrl": "https://my.platform/api/webhook/onboarding",
  "errorsWebhookUrl": "https://my.platform/api/webhook/errors",
  "notificationTypes": [
    "ORDER_CLOSED"
  ],
  "displayName": "My Platform",
  "depositSupported": true,
  "ownNotificationsOnly": true,
  "webhookAuthType": "OAUTH2",
  "webhookAuthDetails": {
    "basic": {
      "username": "LightspeedKSeries",
      "password": "Example-Password"
    },
    "bearer": {
      "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
      "tokenTtl": "2025-01-01T00:00:00"
    },
    "apiKeys": {
      "headers": {
        "X-API-ID": "Example-x-api-id",
        "X-API-SECRET": "Example-x-api-secret"
      },
      "parameters": {
        "key": "string"
      }
    },
    "oauth2": {
      "clientId": "LightspeedKSeries",
      "clientSecret": "Example-Client-Secret",
      "clientName": "LightspeedKSeries",
      "clientAuthorizationMethod": "CLIENT_SECRET_BASIC",
      "authorizationGrantType": "CLIENT_CREDENTIALS",
      "scopes": [
        "webhooks-api"
      ],
      "providerTokenUri": "https://my.platform/emitter/token",
      "providerJwkSetUri": "https://my.platform/public-keys"
    }
  }
}