VBOUT Popups API

The Popups API from VBOUT — 5 operation(s) for popups.

OpenAPI Specification

vbout-popups-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: VBOUT EmailMarketing Popups API
  version: '1.0'
  description: VBOUT Features API documentation
servers:
- url: https://api.vbout.com/1
tags:
- name: Popups
paths:
  WebHook/lists:
    get:
      summary: lists
      tags:
      - Popups
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              examples:
                Example 1:
                  value:
                    webhooks:
                      count: 1
                      items:
                      - id: '107'
                        name: Doctor Request Poll!
                        type: On Page Exit
                        domain_id: '1'
                        url:
                          filter: Matches Exactly
                          link: ''
                        action_type: HTML Message
                        action_rules:
                          execute_for: All Visitors
                          device_filter: All Devices
                          interval: Repeats
                          delay:
                            hours: '0'
                            minutes: '0'
                            seconds: '0'
                        action_stype: Popup
                      - '...'
      operationId: get-WebHook-lists
      description: "**Authentication:** `Required`    \n  - - -  \n  \n**Response Formats:** `XML | JSON`  \n - - -  \n **Parameters:** `None`"
      x-codeSamples:
      - lang: cURL
        source: 'GET https://api.vbout.com/1/webhook/lists.json?key={YOUR_API_ID}

          '
      - lang: PHP
        source: "<?php\n require_once('../PATH/TO/services/WebhookWS.php');\t\n $user_key = array('api_key' => '{YOUR_API_KEY}');\t\n $app = new WebhookWS($user_key);\n $results = $app->getWebhooks();\n print_r($results);\n?>\n"
  Webhook/show:
    get:
      summary: Show
      tags:
      - Popups
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              examples:
                Example 1:
                  value:
                    webhook:
                      id: '107'
                      name: Poll on who will be elected!
                      type: On Page Exit
                      domain_id: '1'
                      url:
                        filter: Matches Exactly
                        link: ''
                      action_type: HTML Message
                      action_rules:
                        execute_for: All Visitors
                        device_filter: All Devices
                        interval: Repeats
                        delay:
                          hours: '0'
                          minutes: '0'
                          seconds: '0'
                      action_stype: Popup
      operationId: get-Webhook-show
      description: "**Authentication:** `Required`    \n  - - -  \n  \n**Response Formats:** `XML | JSON`"
      parameters:
      - schema:
          type: string
          default: None
        in: query
        name: id
        description: The ID of the webhook.<br> **Possible values:**  (ID)
        required: true
      x-codeSamples:
      - lang: cURL
        source: 'GET https://api.vbout.com/1/webhook/show.json?key={YOUR_API_ID}&id=107

          '
      - lang: PHP
        source: "<?php\nrequire_once('../PATH/TO/services/WebhookWS.php');\t\n$user_key = array('api_key' => '{YOUR_API_KEY}');\t\n$app = new WebhookWS($user_key);\n$params = array(\n    'id' => '107',\n);\n$results = $app->getWebhook( $params );\nprint_r($results);\n ?>\n"
  Webhook/Add:
    post:
      summary: Add
      tags:
      - Popups
      operationId: post-Webhook-Add
      description: "**Authentication:** `Required`    \n  - - -  \n  \n**Response Formats:** `XML | JSON`"
      x-codeSamples:
      - lang: cURL
        source: "POST https://api.vbout.com/1/webhook/add.json?key={YOUR_API_ID}\n  id=1\n  name=webhook Name\n  action_type=page_exit\n"
      - lang: PHP
        source: "<?php\nrequire_once('../PATH/TO/services/WebhookWS.php');\t\n$user_key = array('api_key' => '{YOUR_API_KEY}');\t\n$app = new WebhookWS($user_key);\n$params = array(\n    'id' => '1',\n    'name' => 'webhook Name',\n    'action_type' => 'page_exit',\n);\n$results = $app->addNewWebhook( $params );\nprint_r($results);\n ?>\n"
      parameters:
      - schema:
          type: string
          default: None
        in: query
        name: name
        description: The name of the Popup.<br>**Possible values:**  (Text)
        required: true
      - schema:
          type: string
          default: page_exit
        in: query
        name: type
        description: The type of the Popup.<br>**Possible values:**  page_exit | page_entry | goal_trigger
        required: true
      - schema:
          type: integer
          default: None
        in: query
        name: domainid
        description: The Domain id of the Popup.<br>**Possible values:**  (ID)
      - schema:
          type: string
          default: None
        in: query
        name: action_url
        description: Page Url.<br>**Possible values:**   (Text)
      - schema:
          type: string
          default: html_msg
        in: query
        name: action_type
        description: The type of the action.<br>**Possible values:**   html_msg | form | poll | redirection | trigger_js
      - schema:
          type: string
          default: None
        in: query
        name: redirection_url
        description: Redirection URL.<br>**Possible values:**   (Link)
      - schema:
          type: integer
          default: None
        in: query
        name: list_id
        description: The List ID.<br>**Possible values:**   (ID)
      - schema:
          type: string
          default: None
        in: query
        name: poll_question
        description: The Polling Question.<br>**Possible values:**   (Text)
      - schema:
          type: string
          default: None
        in: query
        name: poll_choices
        description: The polling Choices.<br>**Possible values:**   (Text)<br>**Allow multiple:**  `yes`
      - schema:
          type: string
          default: None
        in: query
        name: js_code
        description: The Javascript Code.<br>**Possible values:**   (Text)
      - schema:
          type: string
          default: None
          format: date
        in: query
        name: action_startdate
        description: The Action Trigger Start Date.<br>**Possible values:**  (Date)
      - schema:
          type: string
          format: date
          default: None
        in: query
        name: action_enddate
        description: The Action Trigger End Date.<br>**Possible values:**  (Date)
      - schema:
          type: string
          default: all
        in: query
        name: action_targetusers
        description: The Target Users.<br>**Possible values:**  all | subscribers | anonymous
      - schema:
          type: string
          default: all
        in: query
        name: action_devicefilter
        description: The Device Filter.<br>**Possible values:**  all | desktop | mobile
      - schema:
          type: string
          default: None
        in: query
        name: action_ppcfilter
        description: The PPC Referral Network Filter.<br>**Possible values:**   google | bing | facebook | twitter | linkedin
      - schema:
          type: string
          default: None
        in: query
        name: action_geofilter
        description: The Geo-Location Filter.<br>**Possible values:**    (Text)<br>**Allow Multiple:**  `yes`
      - schema:
          type: string
          default: repeat
        in: query
        name: action_frequency
        description: The Action Frequency.<br>**Possible values:**    repeat | one_time
      - schema:
          type: number
          default: '0'
        in: query
        name: delay_hours
        description: The Delay Number of Hours.<br>**Possible values:**   (Number)
      - schema:
          type: number
          default: '0'
        in: query
        name: delay_minutes
        description: The Delay Number of Minutes.<br>**Possible values:**   (Number)
      - schema:
          type: number
          default: '0'
        in: query
        name: delay_seconds
        description: The Delay Number of Seconds.<br>**Possible values:**   (Number)
      - schema:
          type: string
          default: popup
        in: query
        name: action_style
        description: Choose Action Style.<br>**Possible values:**   popup | sticky_bar
      - schema:
          type: string
          default: None
        in: query
        name: action_text
        description: Action Text.<br>**Possible values:**    (Text)
  Webhook/Edit:
    post:
      summary: Edit
      tags:
      - Popups
      operationId: post-Webhook-Edit
      description: "**Authentication:** `Required`    \n  - - -  \n  \n**Response Formats:** `XML | JSON`"
      x-codeSamples:
      - lang: cURL
        source: "POST https://api.vbout.com/1/webhook/edit.json?key={YOUR_API_ID}\n   id=1\n   name=webhook Name\n   action_type=page_exit\n"
      - lang: PHP
        source: "<?php\nrequire_once('../PATH/TO/services/WebhookWS.php');\t\n$user_key = array('api_key' => '{YOUR_API_KEY}');\t\n$app = new WebhookWS($user_key);\n$params = array(\n    'id' => '1',\n    'name' => 'webhook Name',\n    'action_type' => 'page_exit',\n);\n$results = $app->addNewWebhook( $params );\nprint_r($results);\n ?>\n"
      parameters:
      - schema:
          type: string
          default: None
        in: query
        name: name
        description: The name of the Popup.<br>**Possible values:**  (Text)
        required: true
      - schema:
          type: string
          default: page_exit
        in: query
        required: true
        name: type
        description: The type of the Popup.<br>**Possible values:**  page_exit | page_entry | goal_trigger
      - schema:
          type: string
          default: None
        in: query
        required: true
        name: id
        description: The ID of the Popup.<br>**Possible values:** (ID)
      - schema:
          type: string
          default: None
        in: query
        name: action_url
        description: Page Url.<br>**Possible values:**  (Link)
      - schema:
          type: string
          default: html_msg
        in: query
        name: action_type
        description: The type of the action.<br>**Possible values:**  html_msg | form | poll | redirection | trigger_js
      - schema:
          type: string
          default: None
        in: query
        name: redirection_url
        description: Redirection URL.<br>**Possible values:**  (Link)
      - schema:
          type: string
          default: None
        in: query
        name: list_id
        description: The List ID.<br>**Possible values:**  (ID)
      - schema:
          type: string
          default: None
        in: query
        name: poll_question
        description: The Polling Question.<br>**Possible values:**  (Text)
      - schema:
          type: string
          default: None
        in: query
        name: poll_choices
        description: The polling Choices.<br>**Possible values:**  (Text)<br>**Allow multiple:** `Yes`
      - schema:
          type: string
          default: None
        in: query
        name: js_code
        description: The Javascript Code.<br>**Possible values:**  (Text)
      - schema:
          type: string
          default: None
        in: query
        name: action_startdate
        description: The Action Trigger Start Date.<br>**Possible values:**  (Date)
      - schema:
          type: string
          default: None
        in: query
        name: action_enddate
        description: The Action Trigger End Date.<br>**Possible values:**  (Date)
      - schema:
          type: string
          default: all
        in: query
        name: action_targetusers
        description: The Target Users.<br>**Possible values:**  all | subscribers | anonymous
      - schema:
          type: string
          default: all
        in: query
        name: action_devicefilter
        description: The Device Filter.<br>**Possible values:**   all | desktop | mobile
      - schema:
          type: string
          default: None
        in: query
        name: action_ppcfilter
        description: The PPC Referral Network Filter.<br>**Possible values:**  google | bing | facebook | twitter | linkedin
      - schema:
          type: string
          default: None
        in: query
        name: action_geofilter
        description: action_geofilter<br>**Possible values:** (Text)<br>**Allow multiple:** `Yes`
      - schema:
          type: string
          default: repeat
        in: query
        name: action_frequency
        description: The Action Frequency.<br>**Possible values:** repeat | one_time
      - schema:
          type: string
          default: Number
        in: query
        name: delay_hours
        description: The Delay Number of Hours.<br>**Possible values:** (Number)
      - schema:
          type: string
          default: Number
        in: query
        name: delay_minutes
        description: The Delay Number of Minutes.<br>**Possible values:** (Number)
      - schema:
          type: string
          default: Number
        in: query
        name: delay_seconds
        description: The Delay Number of Seconds.<br>**Possible values:** (Number)
      - schema:
          type: string
          default: popup
        in: query
        name: action_style
        description: Choose Action Style<br>**Possible values:**  popup | sticky_bar
      - schema:
          type: string
          default: None
        in: query
        name: action_text
        description: Action Text.<br>**Possible values:**  (Text)
  Webhook/Delete:
    delete:
      summary: Delete
      tags:
      - Popups
      operationId: delete-Webhook-Delete
      x-codeSamples:
      - lang: cURL
        source: "POST https://api.vbout.com/1/webhook/delete.json?key={YOUR_API_ID}\n   id=1\n"
      - lang: PHP
        source: "<?php\n require_once('../PATH/TO/services/WebhookWS.php');\t\n $user_key = array('api_key' => '{YOUR_API_KEY}');\t\n $app = new WebhookWS($user_key);\n $params = array(\n     'id' => '1',\n );\n $results = $app->removeWebhook( $params );\n print_r($results);\n ?>\n"
      description: "**Authentication:** `Required`    \n  - - -  \n  \n**Response Formats:** `XML | JSON`"
      parameters:
      - schema:
          type: string
          default: None
        in: query
        required: true
        name: id
        description: 'The ID of the Popup to delete.<br>**Possible values:**  (ID) '