Skip to main content
POST
/
v1
/
authors
Create author
curl --request POST \
  --url https://api.marblecms.com/v1/authors \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Doe",
  "slug": "john-doe",
  "bio": "Technical writer and developer",
  "role": "Editor",
  "email": "john@example.com",
  "image": "https://media.marblecms.com/avatar.jpg",
  "socials": [
    {
      "platform": "x",
      "url": "https://x.com/johndoe"
    }
  ]
}
'
{
  "author": {
    "id": "cryitfjp3456lm06xfpzcgl0",
    "name": "John Doe",
    "slug": "john-doe",
    "bio": "Technical writer and developer",
    "role": "Editor",
    "image": "https://media.marblecms.com/avatar.jpg",
    "socials": [
      {
        "url": "https://twitter.com/johndoe",
        "platform": "twitter"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Your Marble API key

Body

application/json
​
name
string
required
Minimum string length: 1
Example:

"John Doe"

​
slug
string
required
Minimum string length: 1
Example:

"john-doe"

​
bio
string | null
Example:

"Technical writer and developer"

​
role
string | null
Example:

"Editor"

​
email
string<email> | null
Example:

"john@example.com"

​
image
string<uri> | null
Example:

"https://media.marblecms.com/avatar.jpg"

​
socials
object[]

Social media links for this author

Response

Author created successfully

​
author
object
required