---
title: "SELLER_ACCOUNT_CHANNEL_UPSERT - Create or update channels"
method: POST
path: "/v1/channels"
tags: ["Channel"]
---

# SELLER_ACCOUNT_CHANNEL_UPSERT - Create or update channels

`POST /v1/channels`

## Request

- Base URL: `https://account.mirakl.net/api/channel-platform`
- URL: `https://account.mirakl.net/api/channel-platform/v1/channels`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-account-channel-platform-apis/docs/v1/channels/post.ts> (a function with typed inputs; its response is checked against the schema)

<div class="extension-title">Description</div>

Api to create or update channels

<div class="api-description-extension">
</div>

## Request body

- SELLERACCOUNTCHANNELUPSERTRequest
  - `channels` SELLERACCOUNTCHANNELUPSERTRequestChannels[], required: Channels to upsert
    - `external_id` string, required: Channel external id
    - `name` string, required: Channel name
    - `status` string, required: Channel status
    - `url` string, required: Channel url

## Response `201`

Channels created or updated

- SELLERACCOUNTCHANNELUPSERTResponse201
  - `channels` SELLERACCOUNTCHANNELUPSERTResponse201Channels[], required: channels
    - `external_id` string: Channel external id
    - `id` string: Channel id
    - `name` string: Channel name
    - `status` string: Channel status Enum: `"AVAILABLE"`
    - `url` string: Channel url
    - `vendor` string: Channel vendor

## Other responses

- `401`: Invalid app-auth token
- `403`: Unknown connector

---

[API](https://skmtc.dev/mirakl/apis/mirakl-account-channel-platform-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-account-channel-platform-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-account-channel-platform-apis/revisions/5adf79cafae2?raw)