external-platform

Get Shopify Status

Get Shopify connection status with optional health check.

Shopify tokens expire roughly every 60 minutes. Use check_health=true to refresh the stored access token if needed and then verify it with a live API call. Refreshing from mf-core is safe because token refreshes are serialized with the UDM pipeline via the shared per-integration advisory lock, so a refresh here can no longer race the pipeline's rotation.

Args: check_health: If true, refresh if needed and perform a live API call to verify token validity

get/api/external-platform/shopify/status

Request

Base URL: https://api.usepomo.ai (the document declares no server; this is the origin it was published from)
URL: https://api.usepomo.ai/api/external-platform/shopify/status
Auth: HTTP bearer

Query parameters

check_healthboolean

Perform live health check

Response

Successful Response

connectedboolean required

Whether the platform is connected

healthyboolean

Whether the token is healthy (passed API check)

health_messagestring nullable

Health check result message

account_idstring nullable

Platform-specific account identifier

account_namestring nullable

Display name for the account

token_expires_soonboolean

Whether token expires within buffer period

last_health_checkstring nullable

ISO timestamp of last health check

shop_domainstring nullable

Shopify store domain

shop_namestring nullable

Shop name

capabilitiesobject

Approved Shopify data capabilities

Example response

{
  "account_id": "shop_12345",
  "account_name": "My Store",
  "connected": true,
  "health_message": "Token is valid",
  "healthy": true,
  "last_health_check": "2024-01-15T10:30:00Z",
  "token_expires_soon": false
}

Changes

No recorded changes to this operation across all 1 revision of this API.