Skip to main content

Access to the Congressus API

You manage your own apps and API keys in the new interface of Congressus Manager. Go to Settings > Apps.

An API key is linked to its own user. By editing that user's user group, you decide which permissions the API key has. Read more about user groups and permissions in Congressus.

Note: the API key is sensitive information! Anyone with this key has access to your association's data. Always protect it and never share it with the users of your application. So don't put it in a mobile app or a single-page application (JavaScript), for example. If Congressus has indications that your API key has become public, we will disable it immediately.

Copying the API key

When you add an API key with Add API key, it is shown once. Copy it straight away and keep it somewhere safe. After that, Congressus shows only the start of the key and it cannot be retrieved. Lost the key? Renew it. New API keys start with cg_live_.

Valid until

An API key works up to and including the date under "Valid until". After that the API refuses it. To keep using the key, open the API key via Settings > Apps and set a new "Valid until" date. The overview shows when each key was "Last used" and whether it has expired.

Renew API key

Want to replace an API key, for example because it has leaked? Open the API key via Settings > Apps and click the Renew API key button under Credentials. After you confirm, you get a new API key straight away, which is shown once. Its permissions stay the same. The current key stops working immediately, so replace it in every application that uses it.


Related articles

Did this answer your question?