---
title: Propel integration sandbox
last-updated: 2026-08-21
---

# Propel integration sandbox

The public sandbox is a real, no-credential dry-run endpoint for testing an
agent or integration's HTTP handling before requesting access to the
authenticated CRM API. It never reads CRM records, issues credentials or
writes to a production system.

## Discover the sandbox

- `GET https://www.propelai.co.uk/api/sandbox` returns the machine-readable
  sandbox contract.
- `GET https://www.propelai.co.uk/sandbox` is an equivalent short route for
  clients that conventionally probe `/sandbox`.
- `POST https://www.propelai.co.uk/api/sandbox` accepts a JSON object with an
  optional `operation`: `health`, `validate_request` or `dry_run`.

Example:

```http
POST /api/sandbox
Content-Type: application/json

{"operation":"validate_request"}
```

Every successful response includes `environment: "sandbox"`, `dryRun: true`
and `wouldWrite: false`. Use the authenticated REST API or MCP endpoint only
after the account owner has provisioned a dedicated bearer key and approved
the requested operation.
