Getting access to the API

To use the Bonsanuncios API, register your application (CRM) on this portal. Once it is verified, you receive a Client ID and a Client Secret.

1. Log in with your Bonsanuncios account

Click “Log in” and enter your Bonsanuncios account details (or create an account). Login uses the OAuth 2.0 standard: the portal never sees your password. You then come back to the portal.

2. Add a new application

In “My applications”, click “Add an application” and fill in the form:

application name (shown to agencies when they connect);
website and a short description of your CRM;
OAuth redirect URI(s) (https) — where Bonsanuncios sends the agency back after connecting;
contact email and phone.

We review every application manually. During the review, the application shows the status Awaiting approval.

3. Receive your Client ID and Client Secret

We email you the result. If the application is approved, the email contains the Client ID and Client Secret (and the webhook secret if you gave a webhook URL). The Client ID is also shown in “My applications”, where you can generate a new secret if the old one is lost.

Next: the documentation — connecting agencies, publishing listings, messages.