Skip to main content

Developer Settings

Self-serve API keys, in-product test console, webhook configuration, delivery logs, and signature verification - all without contacting Valara support.

Available to media_agency account owners from the dashboard sidebar under Developer and Webhooks.

What you can do here

  • Create, rotate, and revoke API keys with per-resource scopes (listings:read, media:write, etc.) - see Authentication and key management.
  • Test the API in-browser with a hybrid console: prefilled curated requests for the 10 public endpoints, plus a custom request tab for ad-hoc debugging - see the in-app /manage/developer/console.
  • Sandbox mode with sk_test_* keys that exercise real webhook delivery to your handler without touching real Square, Mailjet, Google Calendar, or Composio - see Sandbox mode.
  • Configure webhooks, view delivery logs with full retry timelines, replay any past delivery, and verify your HMAC handlers - see Webhooks and the in-app /manage/webhooks/* surface.
  • Inspect audit and data-access history for compliance questions ("who pulled my listing data via API?") - in-app /manage/developer/audit and /manage/developer/access-log.
  • Browse the event catalog and read changelog entries - in-app /manage/developer/docs.

Who has access

The developer settings surface is only available to the agency owner account (role media_agency, rank 6). Team members, brokers, agents, assistants, and viewers cannot see these pages or the underlying /api/v1/agency/* endpoints.

If a non-owner team member tries to access these pages, they receive a 403 Forbidden response (not 404 - the page is known to exist, it is just restricted to the owner).

Where to start

  1. Sign in to the dashboard at https://valara.cloud/login or https://dash.jacoballenmedia.com/login.
  2. Navigate to Developer in the sidebar.
  3. Click API Keys -> Create new key.
  4. Pick Sandbox for your first key (no production data risk while you explore the API).
  5. Open Test Console and run the "List sandbox tours" curated request to confirm your key works end to end.
  6. Read Sandbox mode to understand isolation guarantees before writing any integration code.
  7. When you are ready to ship, create a sk_live_* key with the minimum scopes your integration needs.

API reference

The full OpenAPI spec is published at:

  • https://valara.cloud/api/openapi.json (primary)
  • https://dash.jacoballenmedia.com/api/openapi.json (legacy alias)

A pre-filled Postman collection is downloadable from the in-app /manage/developer/docs tab once you have at least one API key.

Quick reference

PageIn-app pathDoc page
Create / rotate / revoke keys/manage/developer/keysAuthentication
Test console/manage/developer/consoleAuthentication
Sandbox modeKeys tab (Sandbox toggle)Sandbox mode
Endpoint referenceOpenAPI specEndpoints
Configure webhooks/manage/webhooks/endpointsWebhooks
Webhook logs + replay/manage/webhooks/logsWebhooks
Rate limitsDashboard analyticsRate limits
Changelog/manage/developer/docsChangelog
SDK examples-SDKs and examples