Integration Activation

Required

Provider must expose an activation endpoint for Seamlr admin to enable integration.

Endpoint

POST /integrations/activate

Activation Flow

Seamlr admin selects scheduling provider in Superadmin
Enters organization number for the customer
Sends activation request to provider
Provider validates and returns success/failure
Seamlr marks integration as “Live”

Request Schema

{
  "organizationNumber": "556123-4567",
  "seamlrApplicationId": "550e8400-e29b-41d4-a716-446655440000",
  "callbackUrl": "https://api.seamlr.app/api/v3/integrations/{provider}/webhook"
}

Field	Type	Description
`organizationNumber`	string	Swedish organization number
`seamlrApplicationId`	string (UUID)	Unique Seamlr application identifier
`callbackUrl`	string (URL)	Webhook URL for shift notifications

Response Schema

{
  "status": "activated",
  "providerId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "message": "Integration activated successfully"
}

Status	Description
`activated`	Integration is live and ready
`pending`	Activation requires manual approval
`rejected`	Activation was rejected (see message)

Error Handling

{
  "status": "rejected",
  "providerId": null,
  "message": "Organization not found in provider system"
}

Common rejection reasons:

Organization number not found
Organization not eligible for integration
Organization already has an active integration