ONonlymonster
auto-message-campaigns

Retrieve one Auto Messages campaign

Changed on

Rate limit: 5 requests per second

Required permission: auto_messages.view

get/api/v0/accounts/{account_id}/auto-message-campaigns/{campaign_id}

Request

  • Base URL
    https://omapi.onlymonster.ai
  • Auth
    API key in header x-om-auth-token

Path parameters

account_idstring required

OnlyMonster account the campaign belongs to.

campaign_idstring required

Campaign identifier.

Response

One Auto Messages campaign of the account.

idstring required

Campaign identifier.

account_idstring required

OnlyMonster account the campaign belongs to.

namestring required

Campaign name as the account owner set it. Null when the campaign has none.

trigger'welcome_message' | 'online_message' | 'has_expired_message' | 'will_expire_in_message' required
action'send_message' | 'start_mimic' required

What the campaign does when the trigger fires. send_message — sends the messages listed in messages. start_mimic — opens a Mimic chat instead of sending; such a campaign has no messages. Null when this version of the API does not name the action. Such a campaign reports no messages either, since what its content means depends on what it does with it.

status'active' | 'paused' | 'archived' | 'unsending' | 'unsent' required
created_atstring date-time required

When the campaign was created (ISO 8601 Zulu).

targeted_sends_countinteger required

Dispatches the campaign has made since it was created. Cumulative: a fan targeted twice counts twice, and the figure never decreases.

Example response

{
  "id": "4312",
  "account_id": "12345",
  "action": "send_message",
  "created_by": {
    "id": "42"
  },
  "messages": [
    {
      "price_gross": 9.99,
      "attachments": [
        {
          "id": "1289402"
        }
      ],
      "tagged_platform_account_ids": [
        "67890"
      ]
    }
  ]
}

Changes