Skip to main content

Developer Tools

Developer Tools gets SaaSy data and actions out of the product and into your own systems: push events to your endpoints as they happen, pull datasets into a warehouse on a schedule, and let your own apps — or ChatGPT and Slack — invoke your SaaSy agents. For endpoint and authentication details see the API reference; this page covers the screens you use to set things up.

What's included​

PageWhat it's for
WebhooksSubscribe HTTPS endpoints to platform events, inspect deliveries, test, and replay
CRM WebhooksReceive HTTP POSTs when CRM deals are created, updated, deleted, or change stage
Warehouse ExportScheduled exports of your business data to Snowflake, BigQuery, S3, or NDJSON
Agent APIScoped, rate-limited tokens for invoking your agents from your apps, ChatGPT, or Slack

Getting started​

  1. Open Webhooks and select Create endpoint. Add your HTTPS URL and tick the events you want.
  2. Save the signing secret the moment it appears — the banner reads Save your signing secret now.
  3. Use Test to confirm the endpoint is reachable, then View deliveries.
  4. For data in a warehouse, open Warehouse Export and create an export job.
  5. For programmatic agent access, open Agent API and create a token.

Setting up webhooks​

Every delivery is signed with an HMAC in the X-SaaSy-Signature header, so you can verify a request genuinely came from us.

  1. On Webhooks, go to Create endpoint.
  2. Enter the Endpoint URL. It must be HTTPS.
  3. Add an optional Description to tell endpoints apart later.
  4. Under Events to subscribe to, tick at least one event. The picker lists the available event types with a description of each — deal.won and invoice.paid are typical examples.
  5. Select Create endpoint.

Copy the signing secret into your secret manager — you cannot recover it later — then confirm with I've saved it.

Each endpoint row shows its URL, subscribed events, whether it's Active or Paused, and when it was created. Test fires a test event. View deliveries lists recent deliveries with Event, Status, Attempts, Response, and Last attempt; Replay re-sends one that failed.

CRM Webhooks is a separate, deal-focused list. Select Add Webhook, enter the Endpoint URL, and choose from Deal created, Deal updated, Deal deleted, and Stage changed. Rows show consecutive failures and last delivery, and you can Enable or Disable a subscription without deleting it.

Exporting to your warehouse​

Warehouse Export runs scheduled exports so your warehouse can be your source of truth.

  1. Under Create export job, enter a Job name.
  2. Choose a Destination: snowflake, bigquery, s3, or ndjson.
  3. Choose a Cadence: manual, hourly, daily, or weekly.
  4. Tick the Datasets to export.
  5. Add Destination config if your destination needs it — it must be valid JSON.
  6. Select Create export job.

Each job row shows Destination, Datasets, Cadence, status, and last run. Trigger a run with Run full (every row) or Run incremental (only rows changed since the last cursor). View runs shows history with status, mode, rows exported, and timings.

The Documented export schema section lists the stable datasets and the exact columns each emits. Build your models against that contract: columns are only ever added, never renamed or removed without a versioned change.

Using the Agent API​

Tokens are scoped per agent, rate-limited, and every call is metered and audited.

  1. Go to Create a token.
  2. Give it a Name, such as a connector name.
  3. Set Scopes — a comma-separated list of agents, or a wildcard for the whole fleet.
  4. Optionally set a Rate limit / min; leave it blank for the default.
  5. Select Create token and store it immediately. It cannot be retrieved later.

To connect ChatGPT, use View OpenAPI manifest and import that schema as a custom Action with your token as the bearer credential — it also works with any other OpenAPI client. For Slack, add a slash command pointing at the endpoint shown on the page.

The Tokens table lists each token's prefix, scopes, rate limit, creation date, and last use, with Revoke to kill one. The Invocations table logs every agent call — agent, surface, status, latency, and time.

Availability​

Developer Tools is on by default in the SaaS and General packs. On any other pack it's hidden from your sidebar; switch it on under Settings → Navigation.

The module's navigation is not entitlement-gated, but API access is a Growth-plan feature. You need Growth or Scale — on Starter the pages are reachable, but API access isn't included. See Modules, packs, and plans and the API reference.