---
title: "Create Marketing Subscription"
method: POST
path: "/marketing_subscription"
tags: ["Marketing Subscription"]
---

# Create Marketing Subscription

`POST /marketing_subscription`

Create a new marketing subscription

## Query parameters

- `select` string

## Request body

- MarketingSubscription
  - `contact_id` string, uuid — Contact ID
  - `marketing_channel_id` string, uuid — Marketing channel ID
  - `organisation_id` string, uuid — Organisation ID
  - `created_at` string, timestamp with time zone — Marketing subscription creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `key` string, text — Marketing subscription key
  - `status` 'requested' | 'accepted' | 'declined', public.marketing_subscription_status — Status of Marketing subscription
  - `channel_type` 'email' | 'sms' | 'whatsapp' | 'instagram' | 'facebook' | 'google_business_messaging' | 'postal', public.channel_type — Channel Type of Conversation

## Response `200`

The updated Marketing Subscription object

- MarketingSubscription
  - `contact_id` string, uuid — Contact ID
  - `marketing_channel_id` string, uuid — Marketing channel ID
  - `organisation_id` string, uuid — Organisation ID
  - `created_at` string, timestamp with time zone — Marketing subscription creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `key` string, text — Marketing subscription key
  - `status` 'requested' | 'accepted' | 'declined', public.marketing_subscription_status — Status of Marketing subscription
  - `channel_type` 'email' | 'sms' | 'whatsapp' | 'instagram' | 'facebook' | 'google_business_messaging' | 'postal', public.channel_type — Channel Type of Conversation

## Other responses

- `201` — The Marketing Subscription was created
- `204` — No Content

---

[API](https://skmtc.dev/getmateo/apis/mateo-api.md) · [All operations](https://skmtc.dev/getmateo/apis/mateo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getmateo/mateo-api/revisions/22a9b3b009d1/schema)