Skip to main content

Quick Start

Get your first API call working in 5 minutes.

Prerequisites​

  • A tenant bearer token (contact admin to generate one)
  • curl or any HTTP client

1. Verify connectivity​

curl https://ascend-gateway-v5.ascendgtm.workers.dev/health

Expected response:

{"status": "healthy", "services": {"kv": "up", "d1": "up"}}

2. Make your first API call (REST)​

curl -X POST https://ascend-gateway-v5.ascendgtm.workers.dev/api/v1/{tenant}/hubspot \
  -H "Authorization: Bearer {your_token}" \
  -H "Content-Type: application/json" \
  -d '{"action": "list", "object_type": "contacts", "limit": 5}'

3. Discover available APIs​

curl -X POST https://ascend-gateway-v5.ascendgtm.workers.dev/api/v1/{tenant}/discover \
  -H "Authorization: Bearer {your_token}" \
  -H "Content-Type: application/json" \
  -d '{}'

This returns all connected providers with their available endpoints.

4. Use the generic proxy​

For any API not covered by a curated tool:

curl -X POST https://ascend-gateway-v5.ascendgtm.workers.dev/api/v1/{tenant}/call_api \
  -H "Authorization: Bearer {your_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "slack",
    "method": "POST",
    "path": "/chat.postMessage",
    "body": {"channel": "#general", "text": "Hello from the gateway!"}
  }'

Next steps​