Talon.One Stores API

Represents physical or digital stores, branches, and franchises.

Documentation GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/applications/{applicationId}/stores List an Application's stores · List stores #

Ask an LLM

“Which physical or online stores are registered in an Application?”

“Can I list only the stores linked to a specific campaign?”

Tell an agent

List the stores in application {applicationId}.

Show stores in application {applicationId} linked to campaign {campaignId}.

POST /v1/applications/{applicationId}/stores Create a store · Create store #

Ask an LLM

“How do I register a new store in an Application?”

“What fields are required when adding a store?”

Tell an agent

Create store {name} with integration ID {integrationId} and description {description} in application {applicationId}.

Add a new store {name} ({integrationId}), described as {description}, with attributes {attributes} to application {applicationId}.

GET /v1/applications/{applicationId}/stores/{storeId} Get a store's details · Get store #

Ask an LLM

“What attributes are saved for a particular store?”

“Can I look up a store by its store ID?”

Tell an agent

Get store {storeId} in application {applicationId}.

Show the details of store {storeId} (application {applicationId}).

PUT /v1/applications/{applicationId}/stores/{storeId} Update a store's details · Update store #

Ask an LLM

“Can I change a store's name or description after creating it?”

“Which fields must I resend when updating a store?”

Tell an agent

Rename store {storeId} in application {applicationId} to {name}, keeping description {description} and integration ID {integrationId}.

Update store {storeId} in application {applicationId} with attributes {attributes}, name {name}, description {description}, integration ID {integrationId}.

DELETE /v1/applications/{applicationId}/stores/{storeId} Delete a store · Delete store #

Ask an LLM

“How do I remove a closed store from an Application?”

“Can a store be deleted by its ID?”

Tell an agent destructive · confirm first

Delete store {storeId} from application {applicationId}.

Remove the store {storeId} in application {applicationId}.

GET /v1/applications/{applicationId}/campaigns/{campaignId}/stores/export Export the stores linked to a campaign · Export stores #

Ask an LLM

“Can I download the list of stores a campaign runs in?”

“What does the campaign store export CSV contain?”

Tell an agent

Export the stores linked to campaign {campaignId} in application {applicationId}.

Download a CSV of store integration IDs for campaign {campaignId}, application {applicationId}.

DELETE /v1/applications/{applicationId}/campaigns/{campaignId}/stores Unlink all stores from a campaign · Disconnect stores #

Ask an LLM

“How do I stop a campaign from being limited to specific stores?”

“Can I disconnect every store from a campaign at once?”

Tell an agent destructive · confirm first

Disconnect all stores from campaign {campaignId} in application {applicationId}.

Unlink the stores attached to campaign {campaignId} (application {applicationId}).

POST /v1/applications/{applicationId}/campaigns/{campaignId}/stores/import Link stores to a campaign from a CSV · Import stores #

Ask an LLM

“How do I restrict a campaign to a list of stores using a CSV?”

“Does importing campaign stores replace the stores already linked?”

Tell an agent

Import stores from {upFile} into campaign {campaignId} of application {applicationId}.

Replace the stores linked to campaign {campaignId} in application {applicationId} with CSV {upFile}.

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/talon-one:talon-one-stores-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Management Stores API
  version: ''
  description: 'The Management API allows you to programmatically do what the Campaign Manager

    does.'
servers:
- url: https://yourbaseurl.talon.one
security:
- manager_auth: []
- management_key: []
tags:
- name: Stores
  description: Represents physical or digital stores, branches, and franchises.
paths:
  /v1/applications/{applicationId}/stores:
    get:
      operationId: listStores
      summary: List stores
      description: '> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.


        List all stores for a specific Application.'
      tags:
      - Stores
      parameters:
      - $ref: '#/components/parameters/applicationId'
      - $ref: '#/components/parameters/pageSize'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/sort'
      - name: withTotalResultSize
        in: query
        description: 'When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets.


          - When `true`: `totalResultSize` contains the total number of results for this query.

          - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page.

          '
        example: false
        schema:
          type: boolean
      - name: campaignId
        in: query
        description: Filter results by campaign ID.
        example: 49
        schema:
          type: number
      - name: name
        description: The name of the store.
        example: store1
        required: false
        in: query
        schema:
          type: string
      - name: integrationId
        description: The integration ID of the store.
        example: storeId1
        required: false
        in: query
        schema:
          type: string
      - name: query
        description: Filter results by `name` or `integrationId`.
        example: name
        required: false
        in: query
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                - data
                properties:
                  hasMore:
                    type: boolean
                  totalResultSize:
                    type: integer
                    example: 1
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Store'
    post:
      operationId: createStore
      summary: Create store
      description: '> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.


        Create a new store in a specific Application.'
      tags:
      - Stores
      parameters:
      - $ref: '#/components/parameters/applicationId'
      requestBody:
        $ref: '#/components/requestBodies/NewStore'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Store'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict. A store with this integration ID already exists for this application.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
  /v1/applications/{applicationId}/stores/{storeId}:
    get:
      operationId: getStore
      summary: Get store
      description: '> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.


        Get store details for a specific store ID.'
      tags:
      - Stores
      parameters:
      - $ref: '#/components/parameters/applicationId'
      - name: storeId
        required: true
        in: path
        description: 'The ID of the store.

          You can get this ID with the [List stores](#tag/Stores/operation/listStores) endpoint.

          '
        example: '17'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Store'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
    put:
      operationId: updateStore
      summary: Update store
      description: '> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.


        Update store details for a specific store ID.'
      tags:
      - Stores
      parameters:
      - $ref: '#/components/parameters/applicationId'
      - name: storeId
        required: true
        in: path
        description: 'The ID of the store.

          You can get this ID with the [List stores](#tag/Stores/operation/listStores) endpoint.

          '
        example: '17'
        schema:
          type: string
      requestBody:
        $ref: '#/components/requestBodies/NewStore'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Store'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
    delete:
      operationId: deleteStore
      summary: Delete store
      description: '> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.


        Delete the specified store.'
      tags:
      - Stores
      parameters:
      - $ref: '#/components/parameters/applicationId'
      - name: storeId
        required: true
        in: path
        description: 'The ID of the store.

          You can get this ID with the [List stores](#tag/Stores/operation/listStores) endpoint.

          '
        example: '17'
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
  /v1/applications/{applicationId}/campaigns/{campaignId}/stores/export:
    get:
      operationId: exportCampaignStores
      summary: Export stores
      description: '> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.


        Download a CSV file containing the stores linked to a specific campaign.


        > [!tip] If the exported CSV file is too large to view, you can

        > split it into multiple files.


        The CSV file contains the following column:


        - `store_integration_id`: The identifier of the store.'
      tags:
      - Stores
      parameters:
      - $ref: '#/components/parameters/applicationId'
      - $ref: '#/components/parameters/campaignId'
      responses:
        '200':
          description: OK
          content:
            application/csv:
              schema:
                type: string
                format: csv
              examples:
                response:
                  value: 'store_integration_id

                    STORE-001

                    STORE-002

                    STORE-003

                    '
        '400':
          description: Bad request
          content:
            application/csv:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/csv:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
        '404':
          description: Not found
          content:
            application/csv:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
  /v1/applications/{applicationId}/campaigns/{campaignId}/stores:
    delete:
      operationId: disconnectCampaignStores
      summary: Disconnect stores
      description: '> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.


        Disconnect the stores linked to a specific campaign.'
      tags:
      - Stores
      parameters:
      - $ref: '#/components/parameters/applicationId'
      - $ref: '#/components/parameters/campaignId'
      responses:
        '204':
          description: No Content
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
  /v1/applications/{applicationId}/campaigns/{campaignId}/stores/import:
    post:
      operationId: importCampaignStores
      summary: Import stores
      description: '> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.


        Upload a CSV file containing the stores you want to link to a specific campaign.


        Send the file as multipart data.


        The CSV file **must** only contain the following column:

        - `store_integration_id`: The identifier of the store.


        The import **replaces** the previous list of stores linked to the campaign.'
      tags:
      - Stores
      parameters:
      - $ref: '#/components/parameters/applicationId'
      - $ref: '#/components/parameters/campaignId'
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                upFile:
                  description: The CSV file containing the data that is being imported.
                  type: string
                  format: binary
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Import'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithStatus'
components:
  schemas:
    ErrorResponse:
      type: object
      required:
      - message
      properties:
        message:
          type: string
          description: A message describing the error.
        errors:
          type: array
          description: An array of individual problems encountered during the request.
          items:
            $ref: '#/components/schemas/APIError'
    AccountEntity:
      type: object
      required:
      - accountId
      properties:
        accountId:
          type: integer
          description: The ID of the account that owns this entity.
          example: 3886
    Entity:
      type: object
      required:
      - id
      - created
      properties:
        id:
          type: integer
          description: The internal ID of this entity.
          example: 6
        created:
          type: string
          format: date-time
          description: The time this entity was created.
          example: '2020-06-10T09:05:27.993483Z'
    ErrorResponseWithStatus:
      type: object
      properties:
        message:
          type: string
        errors:
          type: array
          description: An array of individual problems encountered during the request.
          items:
            $ref: '#/components/schemas/APIError'
        StatusCode:
          type: integer
          description: The error code
    APIError:
      type: object
      required:
      - source
      - title
      properties:
        title:
          type: string
          description: Short description of the problem.
        details:
          type: string
          description: Longer description of this specific instance of the problem.
        source:
          $ref: '#/components/schemas/ErrorSource'
    Store:
      allOf:
      - $ref: '#/components/schemas/Entity'
      - $ref: '#/components/schemas/NewStore'
      - type: object
        required:
        - updated
        - applicationId
        - integrationId
        - created
        properties:
          created:
            type: string
            format: date-time
            description: The time this entity was created.
            example: '2020-02-07T08:15:22Z'
          applicationId:
            type: integer
            description: The ID of the Application that owns this entity.
            example: 322
          updated:
            type: string
            format: date-time
            description: Timestamp of the most recent update on this entity.
            example: '2021-09-23T10:12:42Z'
          linkedCampaignIds:
            type: array
            description: A list of IDs of the campaigns that are linked with current store.
            items:
              type: integer
            example:
            - 4
            - 6
            - 8
    UserEntity:
      type: object
      required:
      - userId
      properties:
        userId:
          type: integer
          description: The ID of the user associated with this entity.
          example: 388
    UpdateStore:
      type: object
      required:
      - name
      - description
      properties:
        name:
          type: string
          description: The name of the store.
          example: South US store
          minLength: 1
          maxLength: 200
        description:
          type: string
          description: The description of the store.
          example: This is the description of the store in south US.
        attributes:
          type: object
          description: The attributes of the store.
          example:
            country: USA
            code: 1234
    NewStore:
      allOf:
      - $ref: '#/components/schemas/UpdateStore'
      - type: object
        required:
        - integrationId
        properties:
          integrationId:
            type: string
            format: string
            example: STORE-001
            maxLength: 1000
            minLength: 1
            description: 'The integration ID of the store. You choose this ID when you create a store.


              **Note**: You cannot edit the `integrationId` after the store has been created.

              '
    ErrorSource:
      type: object
      description: 'The source of the current error, exactly one of `pointer`, `parameter` or `line` will be defined.

        '
      properties:
        pointer:
          type: string
          description: Pointer to the path in the payload that caused this error.
        parameter:
          type: string
          description: Query parameter that caused this error.
        line:
          type: string
          description: Line number in uploaded multipart file that caused this error. 'N/A' if unknown.
        resource:
          type: string
          description: Pointer to the resource that caused this error.
    Import:
      allOf:
      - $ref: '#/components/schemas/Entity'
      - $ref: '#/components/schemas/AccountEntity'
      - $ref: '#/components/schemas/UserEntity'
      - type: object
        required:
        - amount
        - entity
        properties:
          entity:
            type: string
            example: AttributeAllowedList
            description: 'The name of the entity that was imported.

              '
          amount:
            type: integer
            minimum: 0
            example: 10
            description: The number of values that were imported.
  parameters:
    applicationId:
      name: applicationId
      in: path
      required: true
      description: The ID of the Application. It is displayed in your Talon.One deployment URL.
      example: 42
      schema:
        type: integer
    sort:
      name: sort
      in: query
      required: false
      description: 'The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`.


        **Note:** You may not be able to use all fields for sorting. This is due to performance limitations.

        '
      example: name
      schema:
        type: string
    skip:
      name: skip
      in: query
      required: false
      description: The number of items to skip when paging through large result sets.
      example: 100
      schema:
        type: integer
    pageSize:
      name: pageSize
      in: query
      required: false
      description: The number of items in the response.
      example: 1000
      schema:
        type: integer
        minimum: 1
        maximum: 1000
        default: 1000
    campaignId:
      name: campaignId
      in: path
      description: The ID of the campaign. It is displayed in your Talon.One deployment URL.
      example: 18
      required: true
      schema:
        type: integer
  requestBodies:
    NewStore:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NewStore'
      description: body
      required: true
  securitySchemes:
    manager_auth:
      type: apiKey
      name: Authorization
      in: header
      description: 'This authentication scheme relies on a bearer token that you can use to

        access all the endpoints of the Management API.


        To create the token:


        1. Get a bearer token by calling the

        [createSession](#tag/Sessions/operation/createSession) endpoint.

        1. Use the `token` property of the response in the HTTP header of your

        next queries: `Authorization: Bearer $TOKEN`.


        A token is valid for 3 months. In accordance with best pratices, use

        your generated token for all your API requests. Do **not** regenerate a token for each

        request.


        > [!note]

        > We recommend that you use a [Management API key](https://docs.talon.one/management-api#section/Authentication/management_key)

        > instead of a bearer token.

        '
    management_key:
      type: apiKey
      name: Authorization
      in: header
      description: "The API key authentication gives you access to the endpoints selected by\nthe admin who created the key.\n\nUsing an API key is the recommended authentication method.\n\nThe key must be generated by an admin and given to the developer that\nrequires it:\n\n1. Sign in to the Campaign Manager and click **Account** > **Tools** >\n**Management API Keys**.\n1. Click **Create Key** and give it a name.\n1. Set an expiration date.\n   **Tip**: Avoid choosing expiration dates that fall at the end of the year or during other high-traffic periods.\n1. Choose the endpoints the key should give access to.\n1. Click **Create Key**.\n1. Share it with your developer.\n\nThe developer can now use the API key in the HTTP header, prefixing it\nwith `ManagementKey-v1`:\n\n```\nAuthorization: ManagementKey-v1 bd9479c59e16f9dbc644d33aa74d58270fe13bf3\n```\n"

Talon.One Stores API

Operations 8

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification