Skip to content

Propello Cloud API (3.0.0)

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.

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/

OAuth

OAuth Operations

Operations

User

User Operations

Operations

Group

Organisation Group Operations

Operations

Get Group Details

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" } }

Get Groups List

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": [ {}, {} ] }