Skip to content

Overview:

The Propello API has been created to allow organisations to interact with the Propello platform. There are a lot of different options available to integrators but we will aim to introduce these over the next few sections to help you get up and running quickly.

The rate limit is set to 120 calls per minute, however this can be changed upon request. Please speak to your Customer Success Manager to arrange this. You can view your current rate limit in the CMS in the group settings under the “Integration” tab.

If you have any questions around the integration or onboarding, please email tech@propellocloud.com

Download OpenAPI description
Languages
Servers
Mock server
https://propello-cloud.redocly.app/_mock/openapi
Operations
Operations

Group

Organisation Group Operations

Operations

Request

Security
BearerAuth
Bodyapplication/json

If accessing via an organisation level token you will need to provide an organisation group id in order to indicate which group you are requesting.

organisation_group_idinteger
Example: 1
curl -i -X POST \
  https://propello-cloud.redocly.app/_mock/openapi/v3/group \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "organisation_group_id": 1
  }'

Responses

OK

Bodyapplication/json
statusinteger
Example: 200
timestampstring
Example: "1970-01-30T00:00:00.000000Z"
dataobject
Response
application/json
{ "status": 200, "timestamp": "1970-01-30T00:00:00.000000Z", "data": { "id": 1, "name": "example_org", "display_name": "Example Org. LTD", "sandbox": 0, "locale": "en_GB", "timezone": "Europe/London", "custom_domain": null, "subdomain": "example" } }

Request

Security
BearerAuth
Bodyapplication/json
any
curl -i -X POST \
  https://propello-cloud.redocly.app/_mock/openapi/v3/group/list \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json
statusinteger
Example: 200
timestampstring
Example: "1970-01-30T00:00:00.000000Z"
dataobject
Example: [{"id":1,"name":"example_org","display_name":"Example Org. LTD","sandbox":0,"locale":"en_GB","timezone":"Europe/London","custom_domain":null,"subdomain":"example"},{"id":2,"name":"example_org_sandbox","display_name":"Sandbox Example Org. LTD","sandbox":1,"locale":"en_GB","timezone":"Europe/London","custom_domain":null,"subdomain":"example-sandbox"}]
Response
application/json
{ "status": 200, "timestamp": "1970-01-30T00:00:00.000000Z", "data": [ {}, {} ] }

Offer

Organisation Offer Operations

Operations