How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Vibes Platform API

The complete Vibes Platform REST API as Vibes publishes it — 48 paths and 75 operations across the Acquisition Campaign, Broadcast, Callback, Event, Event-Triggered Campaign, Incentive Code, Incentive Pool, Person, Push Device Manager, Source Code, Subscription, Subscription List, Wallet Campaign, Wallet Messaging, Android/iOS Wallet Template, Wallet Location Selector and Wallet Store Location APIs. HTTP Basic authentication, JSON only, versioned by the X-API-Version header, with US and EU regional hosts.

Vibes Platform API is one of 12 APIs that Vibes Platform publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Mobile Messaging, SMS, MMS, Push Notifications, and Wallet Passes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 75 operations across 48 paths, organized into 18 resource areas, and defines 85 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against 2 base URLs: https://public-api.vibescm.com, https://public-api.eu.vibes.com/.

75 operations 48 paths 85 schemas 8 DELETE39 GET17 POST11 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://public-api.vibescm.com
Authentication
HTTP Basic
Resource Areas
18

Authentication & Security 1

Vibes Platform API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

Paths & Operations 75

Across 48 paths, the API surfaces 75 operations — 8 DELETE, 39 GET, 17 POST, 11 PUT. They span 18 resource areas, including Acquisition Campaign API, Broadcast API, Callback API, Event API, Event-Triggered Campaign API, Incentive Code API, Incentive Pool API, Person API, and 10 more. Each is listed below with its method, path, parameters, and response codes.

Acquisition Campaign API 4
GET
/companies/{company_key}/campaigns/acquisition
Get acquisition campaigns
2 params → 200404
GET
/companies/{company_key}/campaigns/acquisition/{acquisition_id}
Get an acquisition campaign
3 params → 200404
GET
/companies/{company_key}/campaigns/acquisition/{acquisition_id}/participants
Search for pending participants
6 params → 200400
POST
/companies/{company_key}/campaigns/acquisition/{acquisition_id}/participants
Add a participant
4 params body → 200201400409422
Broadcast API 5
POST
/companies/{company_key}/mobiledb/broadcasts/
Create a broadcast
3 params body → 200201
GET
/companies/{company_key}/mobiledb/broadcasts
Get broadcasts
3 params → 200
GET
/companies/{company_key}/mobiledb/broadcasts/{broadcast_id}
Get a broadcast
3 params → 200404
PUT
/companies/{company_key}/mobiledb/broadcasts/{broadcast_id}
Update a broadcast
4 params body → 200403404
DELETE
/companies/{company_key}/mobiledb/broadcasts/{broadcast_id}
Cancel a broadcast
4 params → 200403404
Callback API 6
POST
/companies/{company_key}/config/callbacks/
Register for a new callback type
3 params body → 200201
GET
/companies/{company_key}/config/callbacks/
List registered callbacks
2 params → 200
GET
/companies/{company_key}/config/callbacks/{callback_id}
Get a callback
3 params → 200404
PUT
/companies/{company_key}/config/callbacks/{callback_id}
Update a callback
4 params body → 200201
DELETE
/companies/{company_key}/config/callbacks/{callback_id}
Cancel a callback
4 params → 200404
POST
/companies/{company_key}/config/callback_events/test
Create a test callback event
3 params body → 200201404
Event API 1
POST
/companies/{company_key}/events
Create an event
3 params body → 200202
Event-Triggered Campaign API 5
POST
/companies/{company_key}/mobiledb/event_triggered_messages
Create an event-triggered campaign
3 params body → 200202
GET
/companies/{company_key}/mobiledb/event_triggered_messages
Get event-triggered campaigns
5 params → 200
GET
/companies/{company_key}/mobiledb/event_triggered_messages/{event_triggered_message_id}
Get event-triggered campaign info
4 params → 200404
PUT
/companies/{company_key}/mobiledb/event_triggered_messages/{event_triggered_message_id}
Update an event-triggered campaign
4 params body → 200404422
DELETE
/companies/{company_key}/mobiledb/event_triggered_messages/{event_triggered_message_id}
Cancel an event-triggered campaign
4 params → 200404
Incentive Code API 5
POST
/companies/{company_key}/incentives/pools/{issuance_pool_id}/issuances
Issue an incentive code
4 params body → 200422
GET
/companies/{company_key}/incentives/codes/{incentive_code}
Get incentive code
4 params → 200
GET
/companies/{company_key}/incentives/codes/{incentive_code}/issuances
Get issuances for a code
4 params → 200
POST
/companies/{company_key}/incentives/codes/{incentive_code}/redemptions
Redeem an incentive code
4 params body → 200422
GET
/companies/{company_key}/incentives/codes/{incentive_code}/redemptions
Get redemptions for a code
4 params → 200
Incentive Pool API 4
GET
/companies/{company_key}/incentives/pools
Get incentive pools
1 param → 200
POST
/companies/{company_key}/incentives/pools
Create a new code pool
3 params body → 200
PUT
/companies/{company_key}/incentives/pools/{incentive_pool_id}
Update an existing pool
4 params body → 200
GET
/companies/{company_key}/incentives/pools/{incentive_pool_id}
Get code pool info
4 params → 200
Person API 6
GET
/companies/{company_key}/mobiledb/persons/{person_key}
Get person by personkey
3 params → 200404422
PUT
/companies/{company_key}/mobiledb/persons/{person_key}
Update person by personkey
4 params body → 200201409422
GET
/companies/{company_key}/mobiledb/persons/external/{external_person_id}
Get person by externalpersonid
3 params → 200404422
PUT
/companies/{company_key}/mobiledb/persons/external/{external_person_id}
Update person by externalpersonid
4 params body → 200201409422
GET
/companies/{company_key}/mobiledb/persons
Find person by MDN
3 params → 200400404
POST
/companies/{company_key}/mobiledb/persons/
Add a person
3 params body → 200201409422
Push Device Manager API 4
GET
/companies/{company_key}/mobiledb/persons/{person_key}/push_devices
Get push device info by personkey
3 params → 200404
GET
/companies/{company_key}/mobiledb/persons/external/{external_person_id}/push_devices
Get push device info by externalpersonid
3 params → 200404
GET
/mobile_apps/{app_id}/devices/{vibes_device_id}
Get push device info by vibesdeviceid
3 params → 200404
POST
/mobile_apps/{app_id}/devices/{vibes_device_id}/assign
Associate device with person record
3 params body → 200404422
Source Code API 1
GET
/companies/{company_key}/sourcecodes
Get your active source codes
2 params → 200
Subscription API 6
GET
/companies/{company_key}/mobiledb/persons/{person_key}/subscriptions
Get subscriptions for a personkey
4 params → 200404
GET
/companies/{company_key}/mobiledb/persons/external/{external_person_id}/subscriptions
Get subscriptions for externalpersonid
3 params → 200404
GET
/companies/{company_key}/mobiledb/persons/{person_key}/subscriptions/{subscription_list_id}
Get subscription status for list by personkey
4 params → 200404
DELETE
/companies/{company_key}/mobiledb/persons/{person_key}/subscriptions/{subscription_list_id}
Unsubscribe person by personkey
4 params → 200204404
GET
/companies/{company_key}/mobiledb/persons/external/{external_person_id}/subscriptions/{subscription_list_id}
Get subscription status for list by externalpersonid
4 params → 200404
DELETE
/companies/{company_key}/mobiledb/persons/external/{external_person_id}/subscriptions/{subscription_list_id}
Unsubscribe person by externalpersonid
4 params → 200204404
Subscription List API 4
GET
/companies/{company_key}/mobiledb/subscription_lists/{subscription_list_id}/subscribers
Search for subscriber
6 params → 200404
GET
/companies/{company_key}/mobiledb/subscription_lists/
Get subscription lists
2 params → 200
GET
/companies/{company_key}/mobiledb/subscription_lists/{subscription_list_id}
Get subscription list info
3 params → 200404
GET
/companies/{company_key}/mobiledb/subscription_lists/{subscription_list_id}/acquisition_campaigns/
Get acquisition campaigns for subscription list
3 params → 200404
Wallet Campaign API 7

Manage mobile wallet campaigns and the individual wallet items (passes) issued from them. A wallet campaign is the container for a single offer, loyalty card, or event ticket prog…

GET
/companies/{company_key}/campaigns/wallet
Get wallet campaigns
2 params → 200404
POST
/companies/{company_key}/campaigns/wallet
Create a wallet campaign
3 params body → 201
GET
/companies/{company_key}/campaigns/wallet/{wallet_id}
Get a wallet campaign
3 params → 200404
PUT
/companies/{company_key}/campaigns/wallet/{wallet_id}
Update a wallet campaign
4 params body → 200404
GET
/companies/{company_key}/campaigns/wallet/{wallet_id}/items
Get wallet items
7 params → 200404
GET
/companies/{company_key}/campaigns/wallet/{wallet_id}/items/{wallet_item_id}
Get a wallet item
4 params → 200404
PUT
/companies/{company_key}/campaigns/wallet/{wallet_id}/items/{wallet_item_id}
Update a wallet item
5 params body → 200404
Wallet Messaging API 3

Send push-style messages to the holders of a wallet campaign's passes and review messages that have already been sent. Messages can be targeted to specific recipients with filters…

POST
/companies/{company_key}/campaigns/wallet/{wallet_id}/messages
Create a wallet message
4 params body → 200404
GET
/companies/{company_key}/campaigns/wallet/{wallet_id}/messages
Get wallet messages
3 params → 200404
GET
/companies/{company_key}/campaigns/wallet/{wallet_id}/messages/{wallet_message_id}
Get a wallet message
4 params → 200404
Android Wallet Templates API 3

Define the design and content of the Google Wallet (Android) pass for a wallet campaign. Each campaign has a single Google Wallet template whose fields map to Google Wallet pass c…

GET
/companies/{company_key}/campaigns/wallet/{token}/wallet_template
Get the Google Wallet template
3 params → 200404
POST
/companies/{company_key}/campaigns/wallet/{token}/wallet_template
Create the Google Wallet template
4 params body → 201
PUT
/companies/{company_key}/campaigns/wallet/{token}/wallet_template
Update the Google Wallet template
4 params body → 200404
iOS Wallet Templates API 3

Define the design and content of the Apple Wallet (iOS) pass for a wallet campaign. Each campaign has a single Apple Wallet (passbook) template whose fields map to PassKit pass co…

GET
/companies/{company_key}/campaigns/wallet/{token}/passbook_template
Get the Apple Wallet template
3 params → 200404
POST
/companies/{company_key}/campaigns/wallet/{token}/passbook_template
Create the Apple Wallet template
4 params body → 201
PUT
/companies/{company_key}/campaigns/wallet/{token}/passbook_template
Update the Apple Wallet template
4 params body → 200404
Wallet Location Selector API 4

Configure the branded "Add to Wallet" landing page shown to end users for a wallet campaign, including its image, heading, colors, and language.

GET
/companies/{company_key}/campaigns/wallet/{token}/location_selector
Get the location selector
3 params → 200404
POST
/companies/{company_key}/campaigns/wallet/{token}/location_selector
Create the location selector
4 params body → 201
PUT
/companies/{company_key}/campaigns/wallet/{token}/location_selector
Update the location selector
4 params body → 200404
DELETE
/companies/{company_key}/campaigns/wallet/{token}/location_selector
Delete the location selector
3 params → 204404
Wallet Store Locations API 4

Manage the store locations attached to a wallet campaign. Locations drive geofenced lock-screen notifications that remind pass holders about a nearby store.

GET
/companies/{company_key}/campaigns/wallet/{token}/locations
Get store locations
8 params → 200404
POST
/companies/{company_key}/campaigns/wallet/{token}/locations/bulk
Bulk create store locations
5 params body → 201
DELETE
/companies/{company_key}/campaigns/wallet/{token}/locations/{id}
Delete a store location
4 params → 204404
DELETE
/companies/{company_key}/campaigns/wallet/{token}/locations/delete_all
Delete all store locations
4 params → 200404

Schemas 85

The contract defines 85 schemas that model the data the API accepts and returns. The most detailed are googleWalletTemplateBody (32 properties), callbackResponse (19 properties), appleWalletTemplateBody (15 properties), pushDeviceResponse (13 properties). Each schema is shown below with its type and property counts.

acquisitionResponse
object
10 properties
acquisitionsResponse
array
acquisitionParticipantResponse
object
4 properties
acquisitionParticipantsResponse
array
addParticipantRequest
object
4 properties
addParticipantResponse
object
4 properties
broadcastRequest
object
4 properties 2 required
broadcastResponse
object
7 properties
broadcastsResponse
array
callbackResponse
object
19 properties
callbacksResponse
array
testcallbackRequest
object
8 properties 1 required
callbackRequest-Ack
object
6 properties 2 required
callbackRequest-Event
object
5 properties 3 required
callbackRequest-Person
object
4 properties 2 required
callbackRequest-Push
object
7 properties 2 required
callbackRequest-Sub
object
6 properties 2 required
callbackRequest-SubList
object
4 properties 2 required
callbackRequest-Unmatched
object
5 properties 3 required
callbackRequest-Wallet
object
6 properties 2 required
testCallbackResponse
object
2 properties
eventRequest
object
3 properties 2 required
eventResponse
object
1 property
eventTriggeredResponse
object
8 properties
eventTriggeredsResponse
array
eventTriggeredRequest
object
5 properties 4 required
eventTriggeredRequestMMS
object
5 properties 4 required
eventTriggeredRequestPush
object
5 properties 4 required
incentivePoolResponse
object
10 properties
incentivePoolsResponse
array
incentivePoolRequest
object
6 properties 6 required
incentiveCodeResponse
object
7 properties
incentiveCodeIssuanceRequest
object
4 properties
incentiveCodeIssuanceResponse
object
9 properties
incentiveCodeIssuancesResponse
array
personResponse
object
7 properties
personsResponse
array
personRequest
object
3 properties
pushDeviceResponse
object
13 properties
pushDevicesResponse
array
assignPushDeviceRequest
object
One of externalpersonid OR personkey is required.
2 properties
sourceCodeResponse
object
7 properties
sourceCodesResponse
array
subscriptionResponse
object
6 properties
subscriptionsResponse
array
subscriptionListResponse
object
5 properties
subscriptionListsResponse
array
walletCampaignRequest
object
1 property 1 required
walletCampaignResponse
object
12 properties
walletCampaignsResponse
array
walletItemRequest
object
4 properties
walletItemResponse
object
12 properties
walletItemsResponse
array
walletMessageRequest
object
2 properties 1 required
walletMessageResponse
object
7 properties
walletMessagesResponse
array
locationSelectorBody
object
Branding for the "Add to Wallet" landing page a customer sees before the pass is generated — the page where they pick their store location (drawn from the camp…
6 properties
locationSelectorRequest
object
1 property 1 required
locationSelectorResponse
walletLocation
object
A store location attached to a wallet campaign.
12 properties
walletLocationResponse
walletLocationsResponse
array
walletLocationsBulkRequest
object
1 property 1 required
googleWalletTemplateBody
object
Design and content of a Google Wallet (Android) pass. Google models three pass kinds — Offer, Loyalty, and Event Ticket — that share a common frame; field sema…
32 properties
androidTemplateRequest
object
1 property 1 required
androidTemplateResponse
appleWalletTemplateBody
object
Design and content of an Apple Wallet (iOS) pass — a card with a front and a back whose fields map to fixed regions on the card. Field semantics follow Apple W…
15 properties
passbookField
object
A single label/value entry within an Apple Wallet pass field region.
3 properties
iosTemplateRequest
object
1 property 1 required
iosTemplateResponse
mmsurl
object
2 properties
mmstext
object
2 properties
filters-number
number
filters-string
string
wallet-filters
object
3 properties
wallet-filters-any
object
3 properties
first-class-filters
object
Learn more about first-class fields.
4 properties
first-class-filters-any
object
Learn more about first-class fields.
4 properties
testcallbackRequest-Ack
object
2 properties 1 required
testcallbackRequest-Event
object
2 properties 1 required
testcallbackRequest-Person
object
2 properties 1 required
testcallbackRequest-Push
object
3 properties 1 required
testcallbackRequest-Sub
object
2 properties 1 required
testcallbackRequest-SubList
object
2 properties 1 required
testcallbackRequest-Wallet
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

vibes-platform-api-openapi.json Raw ↑

Other APIs Vibes Platform publishes across the network.

Vibes RCS Business Messaging API
Vibes Platform Acquisition Campaigns API
Vibes Platform Broadcasts API
Vibes Platform Callbacks API
Vibes Platform Carrier Lookup API
Vibes Platform Events API
Vibes Platform Inbound Messages API
Vibes Platform Messages API
Vibes Platform Persons API
Vibes Platform Subscription Lists API
Vibes Platform Wallet Passes API
Where this information came from

This is an independent, third-party profile of Vibes Platform API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.