canonical: https://jentic.com/apis/everflow.io/everflow # Everflow Affiliate API The Everflow Affiliate API is the partner-side surface of the Everflow partner marketing platform. Nine operations across 8 paths cover browsing offers an affiliate is eligible for, applying to offers, pulling click and conversion reporting, listing creatives, and managing postbacks. Authentication is via API key, and the API is the right surface for affiliates who want to automate creative pulls, reconcile clicks and conversions against their own analytics, and feed pixel postbacks into other systems. ## For AI agents Browse and apply to Everflow offers, pull affiliate click and conversion reports, fetch creatives, and manage postbacks for partner marketing automation. ## Scope Does not handle advertiser-side offer creation, payout disbursement, or fraud scoring - use for affiliate-side offer browsing, applications, reporting, and postbacks only. ## Capabilities - List the offers an affiliate is eligible to promote - Read full offer detail before deciding to apply - Apply to a specific offer programmatically - Pull affiliate-side click reporting filtered by date and offer - Pull conversion reporting and entity summaries for performance reconciliation - List creative assets attached to live offers - List and create postbacks for server-to-server tracking ## Use cases ### Performance Reconciliation Reconcile Everflow-reported clicks and conversions against the affiliate's own analytics to detect tracking gaps and disputed conversions early. The `/affiliates/reporting/clicks` and `/affiliates/reporting/conversions` endpoints expose structured data filtered by date and offer. Reconciliation reports run daily in minutes per affiliate. Example prompt: Pull `/affiliates/reporting/clicks` and `/affiliates/reporting/conversions` for the last 7 days and post any offer with a conversion-rate drop greater than 30 percent to Slack ### Offer Discovery and Application Surface eligible offers in an affiliate-facing dashboard and let affiliate managers apply to new offers without leaving the dashboard. The `/affiliates/offers` endpoints list eligible offers, return offer detail, and accept applications. This collapses what is normally a multi-tab process into a single view, saving managers minutes per offer. Example prompt: List all Everflow offers, filter by category 'finance', and apply to the top three by payout via `/affiliates/offers/{offerId}/apply` ### Creative Asset Pipeline Pull every creative for the offers an affiliate runs and push them into a creative library or asset management system, so media buyers always work from the latest banners and copy. `/affiliates/creatives` lists the available creatives. The pipeline runs in seconds per offer and saves designers from manual exports. Example prompt: List creatives via `/affiliates/creatives` and sync any new asset to the team's Google Drive 'Affiliate Creatives' folder ### AI Agent Integration via Jentic Wire Everflow to an AI assistant through Jentic so an affiliate manager can ask 'what was my conversion rate yesterday?' or 'apply me to this new offer' in chat. Jentic search resolves the intent to the right Everflow operation and isolates the API key in the vault. Setup takes minutes once Everflow is connected. Example prompt: Search Jentic for 'everflow click report', load `/affiliates/reporting/clicks`, and answer 'how many clicks did offer 123 get yesterday?' ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/affiliates/offers` | List eligible offers | | GET | `/affiliates/offers/{offerId}` | Get offer detail | | POST | `/affiliates/offers/{offerId}/apply` | Apply to an offer | | POST | `/affiliates/reporting/clicks` | Run a click report | | POST | `/affiliates/reporting/conversions` | Run a conversion report | | POST | `/affiliates/reporting/entity/summary` | Run an entity summary report | | GET | `/affiliates/creatives` | List creatives | | POST | `/affiliates/postbacks` | Create a postback | ## Key resources - **Offers** — List eligible offers, read offer detail, and apply to offers - **Reporting** — Pull click, conversion, and entity-summary reports - **Creatives** — List creative assets attached to offers - **Postbacks** — List and create server-to-server tracking postbacks ## Why Jentic - **Setup:** Wiring the Everflow Affiliate API by hand means learning its X-API-Key header, pointing at the api.eflow.team/v1 base path, and coding the offer, reporting, and postback calls yourself. Through Jentic you install once, import the Everflow Affiliate API from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** Everflow puts the offer id in the URL path (`/affiliates/offers/{offerId}/apply`), so a rule can pin your agent to one offer for browsing and applying. You choose the operations it may call, so applying to an offer is not included unless you add it to reporting and creative reads. - **Credential handling:** Your Everflow 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 'everflow click report' or 'apply to an offer', and Jentic returns the matching Everflow operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Refersion API** — Affiliate marketing platform aimed at e-commerce brands - **Awin API** — Global affiliate network with publisher and advertiser tooling - **Mailchimp Marketing API** — Send affiliate-specific email campaigns with creatives pulled from Everflow - **Slack API** — Push Everflow alerts and reports into Slack channels ## FAQ ### What authentication does the Everflow Affiliate API use? The API uses an API key (ApiKeyAuth scheme). Through Jentic, the key is stored in the encrypted vault and injected at execution time, so the agent never sees the raw secret. ### Can I apply to an Everflow offer through the API? Yes. POST `/affiliates/offers/{offerId}/apply` submits an application for a specific offer. Use GET `/affiliates/offers` and GET `/affiliates/offers/{offerId}` first to confirm eligibility and payout terms. ### What are the rate limits for the Everflow Affiliate API? The OpenAPI spec does not declare explicit rate limits. Treat reporting endpoints as relatively expensive and avoid tight polling; back off on HTTP 429 and check Everflow developer documentation for current published limits. ### How do I pull a click report through Jentic? Search Jentic for 'everflow click report', load the POST `/affiliates/reporting/clicks` operation, and execute it with your date range and offer filters. Install with pip install jentic and use the async search, load, execute pattern. ### Does the Everflow Affiliate API support creating postbacks? Yes. POST `/affiliates/postbacks` creates a postback and GET `/affiliates/postbacks` lists existing ones. This is the right surface for wiring server-to-server conversion tracking into other analytics tools. ### Can I get conversion data without exporting CSVs? Yes. POST `/affiliates/reporting/conversions` returns structured conversion data filtered by offer and date range, removing the need to manually export from the Everflow dashboard. ### Can I limit what my agent is allowed to do with the Everflow Affiliate API? Yes. Because you run Jentic One yourself, you decide which Everflow operations your agent may call, so you can grant read-only access to GET `/affiliates/offers`, GET `/affiliates/creatives`, and the reporting endpoints while withholding write actions like POST `/affiliates/offers/{offerId}/apply` or POST `/affiliates/postbacks.` Since the offer id sits in the URL path, your own rules can pin the agent to a single offer for browsing, applying, or reporting rather than the whole account. Your Everflow API key is held encrypted by your instance and injected only at execution, so the agent never sees the raw secret and can only reach the operations you permit.