API Documentation
Applications ¶
A brand may register external applications (e.g. Contact or Deal apps) that can later be referenced from other parts of the platform — for example, by SSO applications whose authentication_type is Application.
Each application belongs to a brand and has an application_type of Contact, Contacts, Deal, or Generic.
Create an application ¶
Create an applicationPOST/brands/:brand/applications
Creates an application under the given brand. The body must include a url and an application_type (Contact, Contacts, Deal, or Generic).
Example URI
POST /brands/:brand/applications
URI Parameters
- brand
string(required) Example: a62fa02e-b9f4-4e5f-9b11-5691c7a1988a
Request
Body
{
"url": "https://example.com/app",
"application_type": "Deal"
}Response
200Body
{
"code": "OK",
"data": {
"id": "18a440d5-b0ed-4d37-9858-348432c42ae8",
"created_at": 1788494895.950013,
"updated_at": 1788494895.950013,
"deleted_at": null,
"url": "https://example.com/app",
"application_type": "Deal",
"brand": "a62fa02e-b9f4-4e5f-9b11-5691c7a1988a",
"type": "application"
}
}Get applications for a brand ¶
Get applications for a brandGET/brands/:brand/applications
Example URI
GET /brands/:brand/applications
URI Parameters
- brand
string(required) Example: a62fa02e-b9f4-4e5f-9b11-5691c7a1988a
Response
200Body
{
"code": "OK",
"data": [
{
"id": "18a440d5-b0ed-4d37-9858-348432c42ae8",
"created_at": 1788494895.950013,
"updated_at": 1788494895.950013,
"deleted_at": null,
"url": "https://example.com/app",
"application_type": "Deal",
"brand": "a62fa02e-b9f4-4e5f-9b11-5691c7a1988a",
"type": "application"
}
],
"info": {
"count": 1,
"total": 0
}
}