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, 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, Deal, or Generic).
Example URI
POST /brands/:brand/applications
URI Parameters
- brand
string(required) Example: c39defd3-3f01-48b9-9dca-396b3060d20a
Request
Body
{
"url": "https://example.com/app",
"application_type": "Deal"
}Response
200Body
{
"code": "OK",
"data": {
"id": "93a745e9-497f-44fb-9402-180d74312e12",
"created_at": 1779901328.495961,
"updated_at": 1779901328.495961,
"deleted_at": null,
"url": "https://example.com/app",
"application_type": "Deal",
"brand": "c39defd3-3f01-48b9-9dca-396b3060d20a",
"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: c39defd3-3f01-48b9-9dca-396b3060d20a
Response
200Body
{
"code": "OK",
"data": [
{
"id": "93a745e9-497f-44fb-9402-180d74312e12",
"created_at": 1779901328.495961,
"updated_at": 1779901328.495961,
"deleted_at": null,
"url": "https://example.com/app",
"application_type": "Deal",
"brand": "c39defd3-3f01-48b9-9dca-396b3060d20a",
"type": "application"
}
],
"info": {
"count": 1,
"total": 0
}
}