Flinque Developer API documentation
Build custom integrations and automations on top of the Flinque influencer marketing platform. The Flinque REST API gives you programmatic access to creators, campaigns, attribution data, and reports.
Quick start
Get your first API call working in under 5 minutes.
Get API credentials
Generate a client ID and secret in your Flinque workspace under Settings → Developers
Authenticate
Exchange credentials for an access token via the OAuth token endpoint
Make your first call
Use the access token to query any API endpoint with standard HTTPS requests
Authentication
All API requests require authentication via OAuth 2.0 client credentials flow. Pass your access token in the Authorization header on every request.
curl -X POST https://api.flinque.com/v1/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "client_credentials",
"client_id": "your_client_id",
"client_secret": "your_client_secret"
}'
Token lifetime: Access tokens expire after 24 hours. Re-authenticate using your client credentials to get a new token.
Base URL and versioning
All API requests use the following base URL:
Versioning: The current API version is v1. We commit to maintaining v1 for at least 24 months after any future v2 release. Breaking changes will be communicated 90 days in advance via the developer changelog.
Available endpoints
The API exposes the following resource categories. Detailed schema documentation is available in the developer portal.
/creators
Search creators, fetch profiles, audience demographics, engagement metrics, and historical performance
GET /creators/{id}
GET /creators/{id}/audience
GET /creators/{id}/posts
/campaigns
Create and manage campaigns, add creators, track deliverables, and pull performance data
POST /campaigns
GET /campaigns/{id}
PATCH /campaigns/{id}
/attribution
Pull attributed orders, revenue, conversions, and full-funnel attribution data
GET /attribution/revenue
GET /attribution/events
/reports
Generate and export campaign reports, creator scorecards, and dashboard data
POST /reports/generate
GET /reports/{id}/export
/workspaces
Manage workspace settings, team members, and account configuration
GET /workspaces/{id}
GET /workspaces/{id}/members
/webhooks
Subscribe to real-time events: campaign updates, new attributed orders, creator changes
POST /webhooks
DELETE /webhooks/{id}
Webhooks
Subscribe to real-time events instead of polling. Webhooks fire as soon as relevant events occur in your workspace.
Security: All webhook deliveries include an X-Flinque-Signature header. Verify the signature using your webhook secret to confirm authenticity.
Rate limits
Rate limits depend on your Flinque plan. Limits are applied per workspace, not per API key.
Rate limit headers: Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers so you can track your usage.
Error handling
The API uses standard HTTP status codes. All error responses include a structured JSON body.
SDKs and libraries
Official SDKs available in popular languages. Community-maintained libraries also available for additional languages.
JavaScript / TypeScript
Official Node.js + browser SDK
Python
Official Python 3.8+ SDK
REST clients
Postman collection + OpenAPI spec
Or skip the API and use our integrations
If you want to connect Flinque with Shopify, Google Ads, Notion, or one of 14 other tools, you may not need the API. Most common workflows are covered by our pre-built integrations.
- 17 pre-built integrations
- 5 to 15 minute setup
- Maintained and updated by Flinque
- No engineering effort needed
Frequently asked questions
Is the API available on all plans?
Yes. API access is available on Free, Starter, and Enterprise plans, with rate limits scaling by plan. See our pricing page for plan details.
Do you have a sandbox environment?
Yes. Enterprise plans include access to a sandbox workspace at sandbox.flinque.com for safely testing integrations without affecting production data.
How do I report API bugs or request endpoints?
Report bugs through Report an Issue. Request new endpoints via Improvement Feedback.
What about API status and uptime?
Check System Status for real-time API health, scheduled maintenance, and historical incidents. Our SLA target is 99.9% uptime; details in our SLA Policy.
How do you handle API security?
All API traffic is encrypted via TLS 1.2+. Tokens are short-lived and scoped to a specific workspace. See our Security Policy for full details.
Get help from our developer team
Stuck on authentication? Need help with webhook signatures? Want to discuss a custom integration? Our developer team is here.