Jumpseller Apps API

The Apps API from Jumpseller — 3 operation(s) for apps.

GitHub OpenAPI

Operations 5

GET /jsapps.json Retrieve all the Store's JsApps #
POST /jsapps.json Create a Store JsApp #
GET /jsapps/{code}.json Retrieve the JsApps of a given app #
DELETE /jsapps/{id}.json Delete an existing JsApp #
GET /jsapps/{id}.json Retrieve the JsApps of a given app #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/jumpseller-com:jumpseller-com-apps-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jumpseller-com-apps-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Jumpseller Com Apps API
  version: 1.0.0
  x-logo:
    url: https://api.jumpseller.com/images/jumpseller-logo-full.svg
    altText: Jumpseller logo
    href: /
  description: 'Operations tagged Apps across 2 of this provider''s published API definitions: jumpseller-com-openapi-openapi.json, jumpseller-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.jumpseller.com/v1
tags:
- name: Apps
paths:
  /jsapps.json:
    get:
      tags:
      - Apps
      summary: Retrieve all the Store's JsApps
      description: When using an OAuth app token, results are limited to that app's JsApps.
      security:
      - BasicAuthentication:
        - apps
      - loginParameter: []
        authtokenParameter: []
      - OAuth2:
        - read_apps
      parameters: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/JsAppResponse'
              examples:
                success:
                  value:
                  - js_app:
                      id: 1
                      url: https://test.url.com/
                      template: layout
                      element: body
                      application_id: 1
        '404':
          description: No JsApps found for the store (or for the app when using an OAuth token).
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              examples:
                empty_store:
                  value:
                    message: This store doesn't have any JsApps
                empty_app:
                  value:
                    message: This app doesn't have any JsApps
      x-codeSamples:
      - lang: Shell
        label: cURL
        source: curl -u XXXXX:YYYYY -X GET "https://api.jumpseller.com/v1/jsapps.json"
      - lang: PHP
        label: PHP
        source: '<?php

          $login = ''XXXXX'';

          $authtoken = ''YYYYY'';

          $url = ''https://api.jumpseller.com/v1/jsapps.json'';

          $ch = curl_init($url);

          curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

          curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);

          curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);

          $response = curl_exec($ch);

          curl_close($ch);

          echo $response;'
      - lang: Ruby
        label: Ruby
        source: 'require ''net/http''

          require ''json''


          uri = URI(''https://api.jumpseller.com/v1/jsapps.json'')

          http = Net::HTTP.new(uri.host, uri.port)

          http.use_ssl = true


          request = Net::HTTP::Get.new(uri)

          request.basic_auth(''XXXXX'', ''YYYYY'')

          request[''Content-Type''] = ''application/json''


          response = http.request(request)

          puts JSON.parse(response.body)'
      - lang: Python
        label: Python
        source: "import requests\n\nresponse = requests.get(\n    'https://api.jumpseller.com/v1/jsapps.json',\n    auth=('XXXXX', 'YYYYY')\n)\nprint(response.json())"
      - lang: JavaScript
        label: JavaScript
        source: "const response = await fetch('https://api.jumpseller.com/v1/jsapps.json', {\n  method: 'GET',\n  headers: {\n    'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n    'Content-Type': 'application/json'\n  }\n});\n\nconst data = await response.json();\nconsole.log(data);"
      operationId: getJsappsJson
      x-operation-id-source: derived
    post:
      tags:
      - Apps
      summary: Create a Store JsApp
      security:
      - BasicAuthentication:
        - apps
      - loginParameter: []
        authtokenParameter: []
      - OAuth2:
        - read_apps
      parameters: []
      requestBody:
        description: JsApp parameters to create. Requires an OAuth token of the Oauth Application that will own this JsApp.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsAppEdit'
            examples:
              request:
                value:
                  app:
                    url: https://test.url.com/
                    template: layout
                    element: body
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsAppResponse'
              examples:
                success:
                  value:
                    js_app:
                      id: 1
                      url: https://test.url.com/
                      template: layout
                      element: body
                      application_id: 1
        '400':
          description: Bad request, check your parameters.
          content:
            application/json:
              schema:
                type: object
                required:
                - errors
                properties:
                  errors:
                    type: array
                    items:
                      type: string
              examples:
                validation:
                  value:
                    errors:
                    - Element is not included in the list
                    - Template is not included in the list
                    - Oauth application must exist
      x-codegen-request-body-name: body
      x-codeSamples:
      - lang: Shell
        label: cURL
        source: "curl -u XXXXX:YYYYY -X POST \"https://api.jumpseller.com/v1/jsapps.json\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"app\": {\"url\": \"https://example.com\", \"template\": \"layout\", \"element\": \"body\"}}'"
      - lang: PHP
        label: PHP
        source: '<?php

          $login = ''XXXXX'';

          $authtoken = ''YYYYY'';

          $url = ''https://api.jumpseller.com/v1/jsapps.json'';

          $ch = curl_init($url);

          curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

          curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);

          curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);

          curl_setopt($ch, CURLOPT_CUSTOMREQUEST, ''POST'');

          curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([''app'' => [''url'' => ''https://example.com'', ''template'' => ''layout'', ''element'' => ''body'']]));

          $response = curl_exec($ch);

          curl_close($ch);

          echo $response;'
      - lang: Ruby
        label: Ruby
        source: 'require ''net/http''

          require ''json''


          uri = URI(''https://api.jumpseller.com/v1/jsapps.json'')

          http = Net::HTTP.new(uri.host, uri.port)

          http.use_ssl = true


          request = Net::HTTP::Post.new(uri)

          request.basic_auth(''XXXXX'', ''YYYYY'')

          request[''Content-Type''] = ''application/json''

          request.body = { app: { url: ''https://example.com'', template: ''layout'', element: ''body'' } }.to_json


          response = http.request(request)

          puts JSON.parse(response.body)'
      - lang: Python
        label: Python
        source: "import requests\n\nresponse = requests.post(\n    'https://api.jumpseller.com/v1/jsapps.json',\n    auth=('XXXXX', 'YYYYY'),\n    json={'app': {'url': 'https://example.com', 'template': 'layout', 'element': 'body'}}\n)\nprint(response.json())"
      - lang: JavaScript
        label: JavaScript
        source: "const response = await fetch('https://api.jumpseller.com/v1/jsapps.json', {\n  method: 'POST',\n  headers: {\n    'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({\"app\": {\"url\": \"https://example.com\", \"template\": \"layout\", \"element\": \"body\"}})\n});\n\nconst data = await response.json();\nconsole.log(data);"
      operationId: postJsappsJson
      x-operation-id-source: derived
    servers:
    - url: https://api.jumpseller.com/v1
  /jsapps/{code}.json:
    get:
      tags:
      - Apps
      summary: Retrieve the JsApps of a given app
      description: When using an OAuth app token, the {code} must match the token's app.
      security:
      - BasicAuthentication:
        - apps
      - loginParameter: []
        authtokenParameter: []
      - OAuth2:
        - read_apps
      parameters:
      - name: code
        in: path
        description: Code of the app
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/JsAppResponse'
              examples:
                success:
                  value:
                  - js_app:
                      id: 1
                      url: https://test.url.com/
                      template: layout
                      element: body
                      application_id: 1
        '404':
          description: App not found or no JsApps for this app.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              examples:
                app_not_found:
                  value:
                    message: App with code 'test' not found
                empty:
                  value:
                    message: This app doesn't have any JsApps
        '403':
          description: Not authorized to access JsApps for this app.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              examples:
                forbidden:
                  value:
                    message: Not authorized to access JsApps for this app
      x-codeSamples:
      - lang: Shell
        label: cURL
        source: curl -u XXXXX:YYYYY -X GET "https://api.jumpseller.com/v1/jsapps/my-app.json"
      - lang: PHP
        label: PHP
        source: '<?php

          $login = ''XXXXX'';

          $authtoken = ''YYYYY'';

          $url = ''https://api.jumpseller.com/v1/jsapps/my-app.json'';

          $ch = curl_init($url);

          curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

          curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);

          curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);

          $response = curl_exec($ch);

          curl_close($ch);

          echo $response;'
      - lang: Ruby
        label: Ruby
        source: 'require ''net/http''

          require ''json''


          uri = URI(''https://api.jumpseller.com/v1/jsapps/my-app.json'')

          http = Net::HTTP.new(uri.host, uri.port)

          http.use_ssl = true


          request = Net::HTTP::Get.new(uri)

          request.basic_auth(''XXXXX'', ''YYYYY'')

          request[''Content-Type''] = ''application/json''


          response = http.request(request)

          puts JSON.parse(response.body)'
      - lang: Python
        label: Python
        source: "import requests\n\nresponse = requests.get(\n    'https://api.jumpseller.com/v1/jsapps/my-app.json',\n    auth=('XXXXX', 'YYYYY')\n)\nprint(response.json())"
      - lang: JavaScript
        label: JavaScript
        source: "const response = await fetch('https://api.jumpseller.com/v1/jsapps/my-app.json', {\n  method: 'GET',\n  headers: {\n    'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n    'Content-Type': 'application/json'\n  }\n});\n\nconst data = await response.json();\nconsole.log(data);"
      operationId: getJsapps{code}Json
      x-operation-id-source: derived
    servers:
    - url: https://api.jumpseller.com/v1
  /jsapps/{id}.json:
    delete:
      tags:
      - Apps
      summary: Delete an existing JsApp
      description: Only the store that owns the JsApp can delete it. When using an OAuth app token, the JsApp must also belong to that app.
      security:
      - BasicAuthentication:
        - apps
      - loginParameter: []
        authtokenParameter: []
      - OAuth2:
        - read_apps
      parameters:
      - name: id
        in: path
        description: Id of the JsApp
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              examples:
                success:
                  value:
                    message: JsApp deleted
        '403':
          description: Not authorized to delete this JsApp.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              examples:
                forbidden:
                  value:
                    message: Not authorized to delete this JsApp
        '404':
          description: JsApp not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              examples:
                not_found:
                  value:
                    message: JsApp not found
      x-codeSamples:
      - lang: Shell
        label: cURL
        source: curl -u XXXXX:YYYYY -X DELETE "https://api.jumpseller.com/v1/jsapps/123.json"
      - lang: PHP
        label: PHP
        source: '<?php

          $login = ''XXXXX'';

          $authtoken = ''YYYYY'';

          $url = ''https://api.jumpseller.com/v1/jsapps/123.json'';

          $ch = curl_init($url);

          curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

          curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);

          curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);

          $response = curl_exec($ch);

          curl_close($ch);

          echo $response;'
      - lang: Ruby
        label: Ruby
        source: 'require ''net/http''

          require ''json''


          uri = URI(''https://api.jumpseller.com/v1/jsapps/123.json'')

          http = Net::HTTP.new(uri.host, uri.port)

          http.use_ssl = true


          request = Net::HTTP::Delete.new(uri)

          request.basic_auth(''XXXXX'', ''YYYYY'')

          request[''Content-Type''] = ''application/json''


          response = http.request(request)

          puts JSON.parse(response.body)'
      - lang: Python
        label: Python
        source: "import requests\n\nresponse = requests.delete(\n    'https://api.jumpseller.com/v1/jsapps/123.json',\n    auth=('XXXXX', 'YYYYY')\n)\nprint(response.json())"
      - lang: JavaScript
        label: JavaScript
        source: "const response = await fetch('https://api.jumpseller.com/v1/jsapps/123.json', {\n  method: 'DELETE',\n  headers: {\n    'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n    'Content-Type': 'application/json'\n  }\n});\n\nconst data = await response.json();\nconsole.log(data);"
      operationId: deleteJsapps{id}Json
      x-operation-id-source: derived
    get:
      tags:
      - Apps
      summary: Retrieve the JsApps of a given app
      description: Here `{id}` is the app code. When using an OAuth app token, it must match the token's app.
      security:
      - BasicAuthentication:
        - apps
      - loginParameter: []
        authtokenParameter: []
      - OAuth2:
        - read_jsapps
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Code of the app (e.g. `my-app`), not a JsApp id.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/JsAppResponse'
              examples:
                success:
                  value:
                  - js_app:
                      id: 1
                      url: https://test.url.com/
                      template: layout
                      element: body
                      application_id: 1
        '404':
          description: App not found or no JsApps for this app.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              examples:
                app_not_found:
                  value:
                    message: App with code 'test' not found
                empty:
                  value:
                    message: This app doesn't have any JsApps
        '403':
          description: Not authorized to access JsApps for this app.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              examples:
                forbidden:
                  value:
                    message: Not authorized to access JsApps for this app
      x-codeSamples:
      - lang: Shell
        label: cURL
        source: curl -u XXXXX:YYYYY -X GET "https://api.jumpseller.com/v1/jsapps/my-app.json"
      - lang: PHP
        label: PHP
        source: '<?php

          $login = ''XXXXX'';

          $authtoken = ''YYYYY'';

          $url = ''https://api.jumpseller.com/v1/jsapps/my-app.json'';

          $ch = curl_init($url);

          curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

          curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);

          curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);

          $response = curl_exec($ch);

          curl_close($ch);

          echo $response;'
      - lang: Ruby
        label: Ruby
        source: 'require ''net/http''

          require ''json''


          uri = URI(''https://api.jumpseller.com/v1/jsapps/my-app.json'')

          http = Net::HTTP.new(uri.host, uri.port)

          http.use_ssl = true


          request = Net::HTTP::Get.new(uri)

          request.basic_auth(''XXXXX'', ''YYYYY'')

          request[''Content-Type''] = ''application/json''


          response = http.request(request)

          puts JSON.parse(response.body)'
      - lang: Python
        label: Python
        source: "import requests\n\nresponse = requests.get(\n    'https://api.jumpseller.com/v1/jsapps/my-app.json',\n    auth=('XXXXX', 'YYYYY')\n)\nprint(response.json())"
      - lang: JavaScript
        label: JavaScript
        source: "const response = await fetch('https://api.jumpseller.com/v1/jsapps/my-app.json', {\n  method: 'GET',\n  headers: {\n    'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n    'Content-Type': 'application/json'\n  }\n});\n\nconst data = await response.json();\nconsole.log(data);"
      operationId: getJsapps{id}Json
      x-operation-id-source: derived
    servers:
    - url: https://api.jumpseller.com/v1
components:
  schemas:
    JsAppEdit:
      type: object
      required:
      - app
      properties:
        app:
          $ref: '#/components/schemas/JsAppCreate'
    JsAppResponse:
      type: object
      required:
      - js_app
      properties:
        js_app:
          $ref: '#/components/schemas/JsApp'
    JsAppCreate:
      type: object
      required:
      - url
      - template
      - element
      properties:
        url:
          type: string
          description: Url of the HTML to inject
        template:
          type: string
          description: Template of Store Theme to inject HTML
          enum:
          - layout
          - home
          - product
          - page
          - category
          - cart
          - checkout
        element:
          type: string
          description: Element of Template to inject HTML
          enum:
          - body
          - head
    JsApp:
      type: object
      required:
      - id
      - url
      - template
      - element
      - application_id
      properties:
        id:
          type: integer
          description: Unique identifier of the JsApp
          format: int32
        url:
          type: string
          description: Url of the HTML to inject
        template:
          type: string
          description: Template of Store Theme to inject HTML
          enum:
          - layout
          - home
          - product
          - page
          - category
          - cart
          - checkout
        element:
          type: string
          description: Element of Template to inject HTML
          enum:
          - body
          - head
        application_id:
          type: integer
          description: Associated OAuth application id
          format: int32
  securitySchemes:
    BasicAuthentication:
      type: http
      scheme: basic
      description: Basic authentication in the format of `login:authtoken` or `partner_code:auth_token`.
    loginParameter:
      type: apiKey
      in: query
      name: login
      description: API OAuth login. Learn how to get yours [here](#section/Authentication).
    authtokenParameter:
      type: apiKey
      in: query
      name: authtoken
      description: API OAuth token. Learn how to get yours [here](#section/Authentication).
    auth_tokenParameter:
      type: apiKey
      in: query
      name: auth_token
      description: Partner authentication token.
    OAuth2:
      type: oauth2
      description: OAuth 2.0 authorization code flow. Register your app at the Jumpseller Admin Panel to get client credentials. See https://jumpseller.com/support/oauth-2/ for details.
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.jumpseller.com/oauth/authorize
          tokenUrl: https://accounts.jumpseller.com/oauth/token
          refreshUrl: https://accounts.jumpseller.com/oauth/token
          scopes:
            read_products: Read products, variants, images, options, and custom fields
            write_products: Create, update, and delete products
            read_orders: Read orders, fulfillments, and order history
            write_orders: Create, update, and refund orders
            read_customers: Read customer accounts and groups
            write_customers: Create, update, and delete customers
            read_categories: Read product categories
            write_categories: Create, update, and delete categories
            read_store: Read store information and settings
            write_store: Update store settings
            read_settings: Read store configuration
            write_settings: Update store configuration
            read_shipping_methods: Read shipping methods and rates
            write_shipping_methods: Create and update shipping methods
            read_payment_methods: Read payment methods
            write_payment_methods: Create and update payment methods
            read_hooks: Read webhooks
            write_hooks: Create, update, and delete webhooks
            read_promotions: Read promotions and discounts
            write_promotions: Create, update, and delete promotions
            read_taxes: Read tax rules
            write_taxes: Create and update tax rules
            read_pages: Read store pages
            write_pages: Create, update, and delete pages
            read_countries: Read country information
            write_countries: Update country settings
            read_custom_fields: Read product custom fields
            write_custom_fields: Create and update custom fields
            read_checkout_custom_fields: Read checkout additional fields
            write_checkout_custom_fields: Update checkout additional fields
            read_customer_categories: Read customer categories
            write_customer_categories: Create and update customer categories
            read_jsapps: Read JavaScript apps
            write_jsapps: Create, update, and delete JavaScript apps
            read_apps: Read installed apps
            read_fulfillments: Read fulfillment information
            write_fulfillments: Create and update fulfillments
            read_locations: Read warehouse locations
            write_locations: Create and update locations
            write_reviews: Manage product reviews
            read_transaction_ledgers: Read store balance
            write_store_setup: Create new stores via the store setup endpoint
x-refined-from:
- jumpseller-com-openapi-openapi.json
- jumpseller-com-openapi.json