MobAppCreator API

The MobAppCreator API lets you access and manage your app’s resources from your own systems. API access is included on the Advanced and Clone plans.

Authentication

The API uses bearer authentication. Send your API token in the Authorization header of every request, and always use HTTPS:

Authorization: Bearer MOBAPP_API_TOKEN

Generate or delete your API token in the App Dashboard.

List app items

curl --request GET \
  --header 'Authorization: Bearer MOBAPP_API_TOKEN' \
  https://app.mobappcreator.com/api/items

List a screen’s items

curl --request GET \
  --header 'Authorization: Bearer MOBAPP_API_TOKEN' \
  'https://app.mobappcreator.com/api/items/?screenId=SCREEN_ID'

You’ll find the SCREEN_ID in the screen’s settings in the App Dashboard.

Get an item

curl --request GET \
  --header 'Authorization: Bearer MOBAPP_API_TOKEN' \
  https://app.mobappcreator.com/api/items/ITEM_ID

Get the ITEM_ID from the list items call.

Create an item

curl --request POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer MOBAPP_API_TOKEN' \
  --data @item.json \
  https://app.mobappcreator.com/api/items

Example item.json for a news item:

{
  "screenId": "SCREEN_ID",
  "title": "My title",
  "subtitle": "My subtitle",
  "extraData": {
    "image": "IMAGE_URL"
  }
}

A map item:

{
  "screenId": "SCREEN_ID",
  "title": "My title",
  "subtitle": "My subtitle",
  "extraData": {
    "address": "MyStreet 333, Miami, FL",
    "image": "IMAGE_URL",
    "lng": "-80.2994996",
    "lat": "25.7823907"
  }
}

A product item:

{
  "screenId": "SCREEN_ID",
  "title": "My title",
  "subtitle": "My subtitle",
  "extraData": {
    "price": "100",
    "stock": 1,
    "sku": "SKU_NUMBER",
    "image": "IMAGE_URL"
  }
}

Update an item

curl --request PUT \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer MOBAPP_API_TOKEN' \
  --data @item.json \
  https://app.mobappcreator.com/api/items/ITEM_ID

Include only the fields you want to change, for example:

{
  "title": "My updated title",
  "extraData": {
    "price": "120",
    "stock": 5
  }
}

List users

curl --request GET \
  --header 'Authorization: Bearer MOBAPP_API_TOKEN' \
  https://app.mobappcreator.com/api/users

Create a user

curl --request POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer MOBAPP_API_TOKEN' \
  --data @user.json \
  https://app.mobappcreator.com/api/users

{
  "email": "test@mail.com",
  "password": "a-strong-password",
  "name": "Test user",
  "tester": false,
  "disabled": false
}

Update a user

curl --request PUT \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer MOBAPP_API_TOKEN' \
  --data @user.json \
  https://app.mobappcreator.com/api/users/USER_ID

USER_ID is the uid from the user object returned by the list users call. Include only the fields you want to change.

Send a notification to all users

curl --request POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer MOBAPP_API_TOKEN' \
  --data @notification.json \
  https://app.mobappcreator.com/api/notifications

{
  "title": "Test push",
  "body": "This is a test push",
  "actionType": "none",
  "android": true,
  "iOS": true,
  "deliverOn": UNIX_TIMESTAMP
}

Send a notification to one user

curl --request POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer MOBAPP_API_TOKEN' \
  --data @notification.json \
  https://app.mobappcreator.com/api/notifications/USER_ID

{
  "title": "Test push",
  "body": "This is a test push",
  "actionType": "none",
  "deliverOn": UNIX_TIMESTAMP
}