In short: an agency registers once, under its own legal name, and advertises for its clients by entering each client's name in Business name shown to members. The agency pays, holds the balances and receives the invoices. Developers can create and manage Offers and Events through the Agilis REST API (https://ads.agilis.dating) with API keys from the Ad Portal; test keys are free and never shown to members.
For agencies
- Register the agency under its own legal name. → How to register
- When you create an Offer or Event, enter your client's name in Business name shown to members. Members see the client's name, not yours.
- You must be authorised by each client to advertise for them. The Advertising Terms make the agency responsible for this.
Who pays, and who gets invoiced
- Your agency's account pays, in your agency's billing currency.
- Each person in your agency has their own balance and pays from it. The Organisation balance is the total. → How balances work
- Invoices and results are in your agency's name, one invoice per payment, so you can rebill each client.
- To keep each client's spending separate, use one Offer or Event per client and rebill from its invoice.
Team roles
Org Admins and Advertisers work in the Ad Portal; Developers work through the API. Developers can't create Offers or Events in the Ad Portal, but with their API keys they can create, publish and pay for them through the API, and your business is responsible for how its keys are used. The full table is in Team roles and permissions.
The Agilis REST API
- Base URL: https://ads.agilis.dating
- Reference: www.agilis.dating/api-doc, with samples in cURL, Python, Node.js and PHP, and an API assistant
- Machine-readable: OpenAPI 3.1 at www.agilis.dating/openapi.json, Markdown at www.agilis.dating/api-doc.md, and the full text for AI tools at www.agilis.dating/llms-full.txt
- Offers: list your categories and the interests; price an Offer before you create it; create, list, pause, resume and delete Offers; read each Offer's results
- Events: preview, publish, list, edit, reschedule, cancel and delete Events; read each Event's results
Get an API key
- Sign in to the Ad Portal as an Org Admin or Developer.
- Choose Test mode or Live with the switch at the top of the page.
- Go to API keys → Create New Key, give it a name and, if you like, an expiry date.
- Copy the key straight away. You won't be able to see it again.
Test keys start pk_test_; live keys start pk_live_. Each person can have up to 10 keys in each mode. Roll key replaces a key at once, so update your systems first. Send the key in the x-api-key request header: x-api-key: pk_test_….
Build safely
- Build and test with a
pk_test_key: test Offers and Events are free and never shown to members. - Price an Offer with the price-estimate endpoint before you create it.
- Keep keys out of code repositories and browsers; call the API from your server.
Questions
Can an agency manage several clients from one account?
Yes. Register the agency once and name the client on each Offer or Event.
Can each client have its own invoice?
Invoices are issued to your agency, one per payment. Rebill your clients from them.
Is there a sandbox?
Yes. Test mode, with pk_test_ keys, is a full sandbox. Nothing is charged and nothing is shown to members.
Can I connect AI coding tools?
Yes. Point your tool at www.agilis.dating/api-doc.md or www.agilis.dating/openapi.json.
