Developer Docs

const headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer ctl_api_xxxxxx_example_token'
};

# .env file
CONTELL_API_KEY=ctl_api_xxxxxx_example_token
CONTELL_API_URL=https://api.contell.com/v1

const response = await fetch(wpUrl + '/wp-json/wp/v2/posts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Basic ' + btoa(username + ':' + appPassword)
  },
  body: JSON.stringify({
    title: title,
    content: htmlContent,
    status: 'publish'
  })
});

const post = await response.json();
console.log('Published:', post.link);

const response = await fetch(storeUrl + '/admin/api/2023-10/blogs/BLOG_ID/articles.json', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Shopify-Access-Token': token
  },
  body: JSON.stringify({
    article: {
      title: title,
      author: 'Contell AI',
      tags: 'AI, Content, SEO',
      body_html: htmlContent,
      published: true
    }
  })
});

const article = await response.json();
console.log('Published:', article.article.url);

const response = await fetch('https://api.webflow.com/v2/collections/' + collectionId + '/items', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    fieldData: {
      name: title,
      slug: title.toLowerCase().replace(/ /g, '-'),
      'post-body': body,
      'post-summary': excerpt,
      'featured-image': featuredImageUrl
    }
  })
});

const item = await response.json();
console.log('Created:', item.data.id);

import { ok, badRequest } from 'wix-http-functions';
import { posts } from 'wix-blog-backend';

export async function post_contellPublish(request) {
  try {
    const data = await request.body.json();
    const newPost = await posts.createPost({
      title: data.title,
      richContent: data.content,
      tags: data.tags
    });
    return ok({ body: { success: true, post: newPost } });
  } catch (error) {
    return badRequest({ body: { error: error.message } });
  }
}

const ghostAdminToken = createGhostToken(apiKey);
const response = await fetch(ghostUrl + '/ghost/api/admin/posts/', {
  method: 'POST',
  headers: {
    'Authorization': 'Ghost ' + ghostAdminToken,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    posts: [{
      title: title,
      html: content,
      status: 'published',
      feature_image: imageUrl,
      tags: tags
    }]
  })
});

const response = await fetch(
  'https://www.googleapis.com/blogger/v3/blogs/' + blogId +
  '/posts/' + postId + '?key=' + apiKey
);
const post = await response.json();
console.log('Post status:', post.status);

const response = await fetch('https://api.squarespace.com/1.0/content/' + siteId + '/blog', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + apiKey,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: title,
    body: content,
    publishedOn: new Date().toISOString(),
    categories: ['AI', 'Content']
  })
});

const result = await response.json();
console.log('Published:', result.url);

const response = await fetch('https://api.contell.com/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    topic: "Future of AI Marketing",
    keywords: ["marketing", "AI", "SaaS"],
    tone: "professional",
    wordCount: 1500,
    includeImage: true
  })
});

const data = await response.json();
console.log("Generated:", data.id, data.title);

{
  "id": "cnt_abc123",
  "title": "The Future of AI Marketing in 2026",
  "content": "<article>...</article>",
  "excerpt": "A comprehensive look at how AI...",
  "wordCount": 1523,
  "estimatedReadTime": "8 min",
  "keywords": ["marketing", "AI", "SaaS"],
  "featuredImage": "https://cdn.contell.com/img/abc123.jpg",
  "status": "generated",
  "createdAt": "2026-06-06T12:00:00Z"
}

const response = await fetch('https://api.contell.com/v1/schedule', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    contentId: "cnt_abc123",
    platforms: ["wordpress", "shopify"],
    publishAt: "2026-06-15T09:00:00Z",
    timezone: "America/New_York",
    status: "publish"
  })
});

const schedule = await response.json();
console.log("Scheduled:", schedule.id, schedule.publishAt);

const response = await fetch('https://api.contell.com/v1/schedule/bulk', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    items: [
      { topic: "AI Trends 2026", keywords: ["AI"], publishAt: "2026-06-15T09:00:00Z" },
      { topic: "SEO Guide", keywords: ["SEO"], publishAt: "2026-06-17T09:00:00Z" },
      { topic: "Content Strategy", keywords: ["content"], publishAt: "2026-06-20T09:00:00Z" }
    ],
    platformIds: ["wp_123", "shp_456"]
  })
});

import express from 'express';
import crypto from 'crypto';

const app = express();
const WEBHOOK_SECRET = process.env.CONTELL_WEBHOOK_SECRET;

app.post('/contell-webhook', express.json(), (req, res) => {
  const signature = req.headers['x-contell-signature'];
  const payload = JSON.stringify(req.body);
  const expected = crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(payload)
    .digest('hex');

  if (signature !== expected) {
    return res.status(401).send('Invalid signature');
  }

  const event = req.body;
  switch (event.type) {
    case 'content.generated':
      console.log('Content generated:', event.data.title);
      break;
    case 'content.published':
      console.log('Published to:', event.data.platform);
      break;
    case 'content.scheduled':
      console.log('Scheduled for:', event.data.publishAt);
      break;
  }

  res.status(200).send('OK');
});

app.listen(3000);

X-RateLimit-Limit: 50
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1686072000
Retry-After: 8