API Documentation

Build on top of SurveyNow

Use the SurveyNow API to automate surveys, sync contacts, and collect response data in your existing workflows.

Authentication

Use your API key in the Authorization header as a bearer token.

JSON Requests

All request and response bodies are encoded as JSON.

Rate Limits

Default rate limit is 120 requests per minute per API key.

Quick Start

Add your API key and call the endpoint below to list surveys.

curl -X GET "https://api.surveynow.com/v1/surveys" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Core Endpoints

GET/v1/surveys

List all surveys in your workspace.

POST/v1/surveys

Create a new survey with title, questions, and settings.

GET/v1/surveys/{id}/responses

Fetch paginated survey responses.

POST/v1/contacts/sync

Upsert contacts from external systems into SurveyNow CRM.

Webhooks & Events

Need real-time updates? Configure webhooks for response.created, survey.updated, and contact.synced events.