canonical: https://jentic.com/apis/retently.com/retently

# Retently API

The Retently API allows you to manage customer feedback, NPS surveys, and customer data. Base URL: https://app.retently.com. Rate limit: 150 requests/min. The API exposes 8 endpoints secured with apiKey authentication.

## For AI agents

Programmatically list all feedback/responses, create a customer. Covers 8 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for social media only.

## Capabilities

- List all feedback/responses
- Create a customer
- Delete customers
- Unsubscribe a customer from surveys
- Send a survey to a customer
- Add tags to a survey response

## Use cases

### Social Media Operations

Use the Retently API to perform social media operations programmatically. The API provides 8 endpoints covering core functionality including list all feedback/responses, create a customer, list customers.

Example prompt: Call GET /feedback to list all feedback/responses

### Automated Customers Management

Automate customers operations by combining multiple Retently API endpoints. Agents can create a customer and then list customers in a single workflow.

Example prompt: Call POST /customers to create a customer, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Retently API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'list all feedback/responses', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/feedback` | List all feedback/responses |
| POST | `/customers` | Create a customer |
| GET | `/customers` | List customers |
| DELETE | `/customers` | Delete customers |
| POST | `/customers/unsubscribe` | Unsubscribe a customer from surveys |
| POST | `/survey` | Send a survey to a customer |
| POST | `/response/tags` | Add tags to a survey response |
| POST | `/response/topics` | Add topics to a survey response |

## Key resources

- **Customers** — Operations related to Customers
- **Feedback** — Operations related to Feedback
- **Responses** — Operations related to Responses
- **Surveys** — Operations related to Surveys

## Why Jentic

- **Setup:** Wiring the Retently API by hand means passing your API key, targeting the app.retently.com/api/v2 host, and managing feedback, customer, and survey calls yourself. Through Jentic you install once, import Retently API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Retently API takes its targets in the request body rather than a resource id in the URL path. Limit the agent to the operations it needs, such as listing feedback or creating a customer, so it works within the operations you approve.
- **Credential handling:** Your Retently API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list all feedback and responses' or 'send a survey', and Jentic returns the matching Retently API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Facebook** — Alternative social media API
- **Twitter** — Alternative social media API
- **Linkedin** — Complementary social media API

## FAQ

### What authentication does the Retently API use?

The Retently API uses an API key passed in the `X-Api-Key` header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I list all feedback/responses with the Retently API?

Yes. Use the GET /feedback endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Retently API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I list all feedback/responses through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'list all feedback/responses'. Jentic returns the matching Retently API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Retently API have?

The Retently API exposes 8 endpoints covering customers, feedback, responses operations.

### Can I limit what my agent is allowed to do with the Retently API?

Yes. Because Jentic One is self-hosted, you decide which Retently operations your agent may call, so you can grant read-only access to GET /feedback and GET /customers while withholding writes like POST /customers, DELETE /customers, or POST /survey. Since Retently takes its targets in the request body rather than a resource ID in the URL path, restricting the agent to the specific operations you approve is how you keep it inside its intended scope. Your Retently API key is stored encrypted by your own instance and injected only when an approved operation runs, so the agent never sees the raw credential.