Skip to main content
POST
/
v1
/
topics
Node.js SDK
import Migma from 'migma';

const migma = new Migma('YOUR_API_KEY');

const { data, error } = await migma.topics.create({
  name: 'Weekly Newsletter',
  description: 'Our weekly product updates',
  defaultSubscription: 'opt_in',
  projectId: 'PROJECT_ID'
});
{
  "success": true,
  "data": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "defaultSubscription": "opt_in",
    "visibility": "public",
    "displayOrder": 123,
    "isActive": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "error": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key authentication. Use 'Authorization: Bearer YOUR_API_KEY' where YOUR_API_KEY is obtained from the Migma dashboard under Settings → API Integration.

Body

application/json
​
name
string
required
Maximum string length: 100
​
projectId
string
required
​
description
string
Maximum string length: 500
​
defaultSubscription
enum<string>
default:opt_out

Cannot be changed after creation. opt_out means all contacts are subscribed by default.

Available options:
opt_in,
opt_out
​
visibility
enum<string>
default:public
Available options:
public,
private
​
displayOrder
integer
Required range: x >= 0

Response

Topic created

​
success
boolean
required
​
data
object
​
error
string | null