API Access & Webhooks

REST API

RatingsRise provides a REST API for programmatic access to your review data, customer list, and campaign management. Use the API to integrate RatingsRise with your CRM, POS system, or custom applications.

Getting Your API Key

1. Go to Settings → API.
2. Click Generate API Key.
3. Copy your key and store it securely. It is shown only once.

Include the API key in your requests as a Bearer token in the Authorization header:

Authorization: Bearer sk_live_your_api_key_here

API Documentation

Full API documentation is available at ratingsrise.com/docs/api. It covers all available endpoints, request/response schemas, rate limits, and code examples in JavaScript, Python, and cURL.

Webhooks

Webhooks let RatingsRise push real-time events to your server. Instead of polling the API, your application receives an HTTP POST request whenever something happens.

Setting Up Webhooks

1. Go to Settings → Webhooks.
2. Click Add Endpoint.
3. Enter the URL of your server endpoint that will receive webhook events.
4. Select which events you want to subscribe to (e.g., review.created, campaign.completed).
5. Click Save.

Available Webhook Events

• review.created — A new Google review was posted
• review.replied — A reply was posted to a review
• campaign.completed — A campaign finished sending all messages
• customer.created — A new customer was added
• customer.opted_out — A customer opted out of communications
• feedback.received — Private feedback was submitted

Webhook Security

Each webhook delivery includes a signature header (X-RatingsRise-Signature) that you can verify using your webhook secret. This ensures the request actually came from RatingsRise. See the API documentation for signature verification examples.