API Reference
API reference
REST v1 endpoints for publisher integrations.
Partner integrations use /api/v1/publishers on the Publishers host. All routes require authentication unless noted.
Local docs: use Download collection and import the file in Postman (File → Import). Run in Postman needs the public URL at publishers.mypinio.com — Postman cannot fetch collections from localhost.
Endpoints
| Guide | Method | Path | Purpose |
|---|---|---|---|
| API discovery | GET | /api/v1/publishers | List available endpoints |
| Apps API | GET | /api/v1/publishers/apps | List apps |
| Apps API | POST | /api/v1/publishers/apps | Create app |
| Apps API | GET | /api/v1/publishers/apps/{id} | Get app |
| Apps API | PATCH | /api/v1/publishers/apps/{id} | Update app |
| Apps API | DELETE | /api/v1/publishers/apps/{id} | Delete app |
| POST /surveys | POST | /api/v1/publishers/surveys | Request survey offers |
Base URL
https://publishers.mypinio.comLocal development uses your Publishers dev origin (e.g. http://localhost:3003).
Next steps
- Quickstart — first surveys request
- Integration guide — full flow
- Redirect URLs — return links and signatures