Create a blog article

curl --request POST \
  --url https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "example"
}
'

import requests

url = "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles"

payload = { "title": "example" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({title: 'example'})
};

fetch('https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'example'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles"

	payload := strings.NewReader("{\n  \"title\": \"example\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"example\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"example\"\n}"

response = http.request(request)
puts response.read_body

{
  "article": {
    "author": "<string>",
    "blogId": "<string>",
    "bodyHtml": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "excerpt": "<string>",
    "handle": "<string>",
    "id": "<string>",
    "image": {
      "altText": "<string>",
      "url": "<string>"
    },
    "isPublished": true,
    "platform": "shopify",
    "publishDate": "2023-11-07T05:31:56Z",
    "publishedAt": "2023-11-07T05:31:56Z",
    "status": "publish",
    "tags": [
      "<string>"
    ],
    "title": "<string>",
    "updatedAt": "2023-11-07T05:31:56Z",
    "url": "<string>"
  },
  "platform": "shopify"
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "never",
    "retryable": true,
    "type": "<string>"
  }
}

AIsa Social

Create a blog article

Blogs. Acts in public on your connected account; needs social:publish. Audited. Ids are yours: accounts acc_..., profiles prf_..., posts pst_...; every other object id is checked against your accounts before the call. Creates an article on the blog. Supported on Shopify (`shopify`), WordPress (`wordpress`), Wix (`wix`) and Webflow (`webflow`). ### Publishing behavior - WordPress, Wix and Webflow default to a draft when both publishing fields are omitted. - `isPublished: false` keeps the article as a draft and takes priority over a future `publishDate`. - A future `publishDate` schedules publication natively on the platform. The platform publishes it at that time with no AIsa queue involved. - `isPublished: true` publishes immediately when there is no future `publishDate`. - WordPress native scheduling depends on the site's scheduler/WP-Cron. ### SEO `seo.title` / `seo.description` map to: - Shopify: the global `title_tag` and `description_tag` metafields (the fields Shopify themes read for the page title and meta description). - Wix: the post's SEO title and meta description. WordPress and Webflow reject `seo`; SEO plugin and custom-field writes are not supported. ### Webflow Webflow has no scheduling API: a future `publishDate` returns 400 unless `isPublished: false` keeps a draft. Fields map to the collection's own fields by type and slug: - The body goes to its rich text field. - `excerpt` goes to a summary field. - `image` goes to an image field. - `tags` and `author` go to tag and author reference fields. Sending a field the collection does not have returns 400, as does a collection that requires a field the Blogs API cannot fill. ### Wix Wix stores rich content. `bodyHtml` is converted on write (each top-level HTML element must fit 30,000 characters), and images in the body are imported into the site's Media Manager. ### Idempotency Send an Idempotency-Key header to make retries safe. A retry with the same key and body replays the original 201 instead of creating a second article. A retry while the first request is still running returns 409; retry after a short backoff.  A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.

POST

https://api.aisa.one

apis

social

accounts

{accountId}

blogs

{blogId}

articles

Create a blog article

curl --request POST \
  --url https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "example"
}
'

import requests

url = "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles"

payload = { "title": "example" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({title: 'example'})
};

fetch('https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'example'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles"

	payload := strings.NewReader("{\n  \"title\": \"example\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"example\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"example\"\n}"

response = http.request(request)
puts response.read_body

{
  "article": {
    "author": "<string>",
    "blogId": "<string>",
    "bodyHtml": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "excerpt": "<string>",
    "handle": "<string>",
    "id": "<string>",
    "image": {
      "altText": "<string>",
      "url": "<string>"
    },
    "isPublished": true,
    "platform": "shopify",
    "publishDate": "2023-11-07T05:31:56Z",
    "publishedAt": "2023-11-07T05:31:56Z",
    "status": "publish",
    "tags": [
      "<string>"
    ],
    "title": "<string>",
    "updatedAt": "2023-11-07T05:31:56Z",
    "url": "<string>"
  },
  "platform": "shopify"
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "never",
    "retryable": true,
    "type": "<string>"
  }
}

Request contract

Method and path: POST /apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles
accountId: path; required
blogId: path; required
Idempotency-Key: header; optional
Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_aisa_social_apis_v1_social_accounts_accounti_9e8439",
  "method": "POST",
  "path": "/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "One of your social accounts (acc_...).",
      "in": "path",
      "name": "accountId",
      "required": true,
      "schema": {
        "pattern": "^acc_[0-9A-Za-z]{22}$",
        "type": "string"
      }
    },
    {
      "description": "Platform-native blog/site id returned by the list operation.",
      "in": "path",
      "name": "blogId",
      "required": true,
      "schema": {
        "pattern": "^[A-Za-z0-9_-]{1,64}$",
        "type": "string"
      }
    },
    {
      "description": "Passed to the channel: a retry with the same key within 24 hours returns the first result instead of acting twice. AIsa never retries a write for you.",
      "in": "header",
      "name": "Idempotency-Key",
      "required": false,
      "schema": {
        "maxLength": 191,
        "minLength": 1,
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "example": {
          "title": "example"
        },
        "schema": {
          "properties": {
            "author": {
              "description": "Shopify author display name, numeric WordPress user id serialized as a string, or Wix site member id. Assigning another WordPress user may require elevated capability. Wix posts without one go to the site's default author.",
              "type": "string"
            },
            "bodyHtml": {
              "description": "Article body as HTML.",
              "type": "string"
            },
            "excerpt": {
              "description": "Short summary shown in blog listings.",
              "type": "string"
            },
            "fieldData": {
              "additionalProperties": true,
              "description": "Webflow only (other platforms answer 400). The collection's own fields that the Blogs API does not map, keyed by field slug, in Webflow's value format (a Reference is an item id, an Image is { url, alt }).\n\nRequired by collections with required fields of their own: a create that leaves one empty answers 400 listing them. A slug the API already fills (name, slug, body, summary, image, tags, author, date) or one the collection lacks answers 400.",
              "type": "object"
            },
            "handle": {
              "description": "URL slug. Generated from the title when omitted.",
              "type": "string"
            },
            "image": {
              "description": "Featured image from a public URL. WordPress downloads it into the media library and Wix imports it into the Media Manager; JPEG, PNG, GIF and WebP are accepted up to 10 MB.",
              "properties": {
                "altText": {
                  "type": "string"
                },
                "url": {
                  "format": "uri",
                  "type": "string"
                }
              },
              "required": [
                "url"
              ],
              "type": "object"
            },
            "isPublished": {
              "description": "Set false for a draft or true to publish. On WordPress and Wix false takes priority over a future publishDate; omission with no date defaults to draft.",
              "type": "boolean"
            },
            "publishDate": {
              "description": "ISO 8601 datetime with offset (or Z). A future date schedules publication natively on the platform.",
              "format": "date-time",
              "type": "string"
            },
            "seo": {
              "description": "Shopify and Wix. Search-engine overrides: Shopify global title_tag and description_tag metafields, Wix post SEO title and meta description. WordPress rejects this field.",
              "properties": {
                "description": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "tags": {
              "description": "Tag names. WordPress and Wix resolve existing names case-insensitively and create missing tags (Wix allows up to 30).",
              "items": {
                "minLength": 1,
                "type": "string"
              },
              "maxItems": 100,
              "type": "array"
            },
            "title": {
              "minLength": 1,
              "type": "string"
            }
          },
          "required": [
            "title"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "description": "Included with your connected social accounts: AIsa does not charge per call.",
    "kind": "no_customer_charge"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key

string

Passed to the channel: a retry with the same key within 24 hours returns the first result instead of acting twice. AIsa never retries a write for you.

Required string length: 1 - 191

Path Parameters

accountId

string

required

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$

blogId

string

required

Platform-native blog/site id returned by the list operation.

Pattern: ^[A-Za-z0-9_-]{1,64}$

Body

application/json

title

string

required

Minimum string length: 1

author

string

Shopify author display name, numeric WordPress user id serialized as a string, or Wix site member id. Assigning another WordPress user may require elevated capability. Wix posts without one go to the site's default author.

bodyHtml

string

Article body as HTML.

excerpt

string

Short summary shown in blog listings.

fieldData

object

Webflow only (other platforms answer 400). The collection's own fields that the Blogs API does not map, keyed by field slug, in Webflow's value format (a Reference is an item id, an Image is { url, alt }).

Required by collections with required fields of their own: a create that leaves one empty answers 400 listing them. A slug the API already fills (name, slug, body, summary, image, tags, author, date) or one the collection lacks answers 400.

handle

string

URL slug. Generated from the title when omitted.

image

object

Featured image from a public URL. WordPress downloads it into the media library and Wix imports it into the Media Manager; JPEG, PNG, GIF and WebP are accepted up to 10 MB.

Show child attributes

isPublished

boolean

Set false for a draft or true to publish. On WordPress and Wix false takes priority over a future publishDate; omission with no date defaults to draft.

publishDate

string<date-time>

ISO 8601 datetime with offset (or Z). A future date schedules publication natively on the platform.

seo

object

Shopify and Wix. Search-engine overrides: Shopify global title_tag and description_tag metafields, Wix post SEO title and meta description. WordPress rejects this field.

Show child attributes

Response

Article created

article

object

An article inside a blog on the connected platform.

Show child attributes

platform

enum<string>

Available options:

shopify,

wordpress,

wix,

webflow

​Request contract

​Cost and request rules

Authorizations

Headers

Path Parameters

Body

Response

Request contract

Cost and request rules