Omnisend

Omnisend Products API

The Products API from Omnisend — 5 operation(s) for products. Version 2026-03-15, harvested from Omnisend's published contract.

Documentation GitHub OpenAPI

Operations 5

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 /products List products in the catalog · List products #

Ask an LLM

“Which products are in my synced catalog?”

“Can I sort and page through my product list?”

Tell an agent

List products sorted by {sort}.

List {limit} products starting at offset {offset}.

POST /products Create a product · Create product #

Ask an LLM

“How do I add a new product with its variants and images?”

“What fields are required to create a product: ID, title, URL, currency, status?”

Tell an agent

Create product {id} titled {title} at {url} in {currency} with status {status}.

Add new product {id} called {title} with variants {variants}.

DELETE /products/{productID} Delete a product · Delete product #

Ask an LLM

“Can I delete a product I no longer sell?”

“Is there a way to remove a product from my synced catalog?”

Tell an agent destructive · confirm first

Delete product {productID}.

Remove product {productID} from the catalog.

GET /products/{productID} Get one product · Get product #

Ask an LLM

“Can I fetch a single product by its ID?”

“What variants and images does a specific product have?”

Tell an agent

Get product {productID}.

Show the details and variants of product {productID}.

PUT /products/{productID} Replace a product · Replace product #

Ask an LLM

“Can I overwrite an existing product record with an updated title and variants?”

“Which fields must I resend when replacing a product that's already synced?”

Tell an agent

Replace product {productID} with new variants {variants}.

Overwrite existing product {productID} with title {title} and status {status}.

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/omnisend:omnisend-products-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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:
  contact: {}
  title: Products API
  version: '2026'
servers:
- url: https://api.omnisend.com/api
tags:
- name: Products
paths:
  /products:
    get:
      description: 'List products


        **Scopes:**

        `products.read`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.


        Guide: Sync products catalog, categories


        Open Postman collection'
      parameters:
      - description: Offset
        in: query
        name: offset
        schema:
          type: integer
          default: 0
      - description: Limit
        in: query
        name: limit
        schema:
          type: integer
          default: 100
      - description: Sort by
        in: query
        name: sort
        schema:
          type: string
          enum:
          - date
          - updatedAt
          - createdAt
      - $ref: '#/components/parameters/APIVersionHeader'
      responses:
        '200':
          description: List of products
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListProductsResponse'
        '400':
          description: Validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblem'
        '401':
          description: Authentication is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - products.read
      - ApiKeyAuth: []
      summary: List products
      tags:
      - Products
      operationId: getProducts
      x-operation-id-source: derived
    post:
      description: 'Creates a new product


        **Scopes:**

        `products.write`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.


        Open Postman collection'
      parameters:
      - $ref: '#/components/parameters/APIVersionHeader'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Product'
        description: Product to create
        required: true
      responses:
        '201':
          description: Product created successfully with the given ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateProductResponse'
        '400':
          description: Validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblem'
        '401':
          description: Authentication is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Product already exists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - products.write
      - ApiKeyAuth: []
      summary: Create product
      tags:
      - Products
      operationId: postProducts
      x-operation-id-source: derived
  /products/{productID}:
    delete:
      description: 'Delete product by ID


        **Scopes:**

        `products.write`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.


        Open Postman collection'
      parameters:
      - description: Product ID
        in: path
        name: productID
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/APIVersionHeader'
      responses:
        '204':
          description: No Content
        '400':
          description: Validation failed
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ValidationProblem'
        '401':
          description: Authentication is missing or invalid
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal server error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - products.write
      - ApiKeyAuth: []
      summary: Delete product
      tags:
      - Products
      operationId: deleteProductsByProductID
      x-operation-id-source: derived
    get:
      description: 'Get product by ID


        **Scopes:**

        `products.read`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.


        Open Postman collection'
      parameters:
      - description: Product ID
        in: path
        name: productID
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/APIVersionHeader'
      responses:
        '200':
          description: Product found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Product'
        '401':
          description: Authentication is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: Product not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - products.read
      - ApiKeyAuth: []
      summary: Get product
      tags:
      - Products
      operationId: getProductsByProductID
      x-operation-id-source: derived
    put:
      description: 'Replace product by ID


        **Scopes:**

        `products.write`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.


        Open Postman collection'
      parameters:
      - description: Product ID
        in: path
        name: productID
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/APIVersionHeader'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Product'
        description: Product to replace
        required: true
      responses:
        '200':
          description: Product replaced successfully with the given ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReplaceProductResponse'
        '400':
          description: Validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblem'
        '401':
          description: Authentication is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: Product not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - products.write
      - ApiKeyAuth: []
      summary: Replace product
      tags:
      - Products
      operationId: putProductsByProductID
      x-operation-id-source: derived
components:
  schemas:
    Problem:
      description: Standard error response returned by all API endpoints on failure.
      properties:
        detail:
          description: Human-readable explanation of this specific error occurrence
          example: A human-readable explanation of the error.
          type: string
        instance:
          description: Request trace identifier for support and debugging
          example: urn:omnisend:request:00000000-0000-0000-0000-000000000001
          type: string
        status:
          description: HTTP status code
          example: 0
          type: integer
        title:
          description: Short description of the error type
          example: Problem
          type: string
        type:
          description: URI that identifies the error type
          example: https://problems.omnisend.com/problem
          type: string
      type: object
    ReplaceProductResponse:
      properties:
        id:
          example: shoes-blue-123
          type: string
      type: object
    ListProductsResponse:
      properties:
        paging:
          $ref: '#/components/schemas/Paging'
        products:
          items:
            $ref: '#/components/schemas/Product'
          type: array
      type: object
    ValidationProblem:
      description: Error response returned when the request contains invalid input. The errors array lists every field that failed validation.
      properties:
        detail:
          description: Human-readable explanation of this specific error occurrence
          example: A human-readable explanation of the error.
          type: string
        errors:
          description: List of fields that failed validation
          items:
            $ref: '#/components/schemas/FieldError'
          type: array
        instance:
          description: Request trace identifier for support and debugging
          example: urn:omnisend:request:00000000-0000-0000-0000-000000000001
          type: string
        status:
          description: HTTP status code
          example: 0
          type: integer
        title:
          description: Short description of the error type
          example: Problem
          type: string
        type:
          description: URI that identifies the error type
          example: https://problems.omnisend.com/problem
          type: string
      type: object
    Product:
      properties:
        categoryIDs:
          example:
          - '1234567890'
          - '99934567890'
          items:
            type: string
          maxItems: 100
          type: array
        createdAt:
          example: '2021-01-01T00:00:00Z'
          type: string
        currency:
          example: USD
          type: string
        defaultImageUrl:
          description: DefaultImageUrl is recommended if more than one image is needed. Other product images should be added to the Images array.
          example: https://example.com/image.jpg
          maxLength: 1000
          type: string
        description:
          description: Description is a short description of the product. It can be used in the email body.
          example: My product description
          maxLength: 1000
          type: string
        id:
          example: '1234567890'
          maxLength: 100
          type: string
        images:
          example:
          - https://example.com/image.jpg
          - https://example.com/image2.jpg
          items:
            type: string
          maxItems: 300
          type: array
        status:
          description: Status can be inStock, outOfStock, or notAvailable. We recommended to keep it in sync with your shop product to ensure that Omnisend can avoid sending out-of-stock products to your customers.
          enum:
          - inStock
          - outOfStock
          - notAvailable
          example: inStock
          type: string
        tags:
          description: Tags can be used to categorize products.
          example:
          - tag1
          - tag2
          - tag3
          items:
            type: string
          maxItems: 100
          type: array
        title:
          example: My Product
          maxLength: 255
          type: string
        type:
          description: Product type can be used to categorize products.
          example: Super Product
          maxLength: 100
          type: string
        updatedAt:
          example: '2021-01-01T00:00:00Z'
          type: string
        url:
          description: Url should point to the product page on the website.
          example: https://example.com/product
          maxLength: 1000
          type: string
        variants:
          description: Product variants are different versions of the same product. For example, a T-shirt can have different sizes and colors.
          items:
            $ref: '#/components/schemas/Variant'
          maxItems: 500
          minItems: 1
          type: array
        vendor:
          description: Vendor is the manufacturer or the brand of the product.
          example: My Vendor
          maxLength: 100
          type: string
      required:
      - currency
      - id
      - status
      - title
      - url
      type: object
    CreateProductResponse:
      properties:
        id:
          example: shoes-blue-123
          type: string
      type: object
    Variant:
      properties:
        defaultImageUrl:
          description: DefaultImageUrl is recommended if more than one image is needed. Other product images should be added to the Images array.
          example: https://example.com/variantImage.jpg
          maxLength: 1000
          type: string
        description:
          description: Description is a short description of the product. It can be used in the email body.
          example: My variant description
          maxLength: 1000
          type: string
        id:
          example: '1234567890'
          maxLength: 100
          type: string
        images:
          example:
          - https://example.com/variant/image.jpg
          - https://example.com/variant/image2.jpg
          items:
            type: string
          maxItems: 300
          type: array
        price:
          example: 9.99
          type: number
        sku:
          example: SKU1234567890
          maxLength: 255
          type: string
        status:
          description: Status can be inStock, outOfStock, or notAvailable. We recommended to keep it in sync with your shop product to ensure that Omnisend can avoid sending out-of-stock products to your customers.
          enum:
          - inStock
          - outOfStock
          - notAvailable
          example: inStock
          type: string
        strikeThroughPrice:
          description: StrikeThroughPrice is the price before the discount.
          example: 19.99
          type: number
        title:
          example: My Variant
          maxLength: 255
          type: string
        url:
          example: https://example.com/variant
          maxLength: 1000
          type: string
      required:
      - id
      - price
      - title
      - url
      type: object
    Paging:
      properties:
        limit:
          example: 100
          type: integer
        next:
          example: https://api.omnisend.com/api/products?limit=100&offset=105
          type: string
        offset:
          example: 5
          type: integer
        previous:
          example: https://api.omnisend.com/api/products?limit=100&offset=5
          type: string
      type: object
    FieldError:
      description: A single field validation failure within a validation error response.
      properties:
        code:
          description: Error code indicating the type of failure
          example: invalid_format
          type: string
        field:
          description: Dot-separated path to the field that failed validation
          example: content.email.subject
          type: string
        message:
          description: Human-readable explanation of what is wrong with the field value
          example: Must be a valid email address
          type: string
      type: object
  parameters:
    APIVersionHeader:
      description: API version that specifies the response format and behaviour
      in: header
      name: Omnisend-Version
      required: true
      schema:
        type: string
        default: '2026-03-15'
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: Authorization
      type: apiKey
    Bearer:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://app.omnisend.com/oauth2/token
          scopes: {}

Omnisend Products API

Operations 5

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification