Skip to main content
POST
/
lists
cURL
curl --request POST \
  --url https://letterby.com/api/v4/lists \
  --header 'Content-Type: application/json' \
  --header 'apiKey: <api-key>' \
  --data '
{
  "name": "<string>",
  "url": "<string>",
  "desc": "<string>"
}
'
{
  "data": {
    "list": {
      "id": "<string>",
      "url": "<string>",
      "branding": true,
      "startFrom": 123,
      "mode": "<string>",
      "name": "<string>",
      "referrals": true,
      "color": "<string>",
      "title": "<string>",
      "desc": "<string>",
      "socialDescription": "<string>",
      "senderName": "<string>",
      "replyTo": "<string>",
      "sender": "<string>",
      "legal": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "userId": "<string>",
      "domainId": "<string>",
      "defaultPageId": "<string>",
      "referralPageId": "<string>",
      "successPageId": "<string>",
      "icon": "<string>",
      "favicon": "<string>",
      "ogImage": "<string>",
      "listSettingsId": "<string>",
      "whitelistEmailId": "<string>",
      "templateId": "<string>",
      "themeId": "<string>",
      "columns": [
        "<string>"
      ],
      "customHeadCode": "<string>",
      "customBodyCode": "<string>",
      "googleAnalytics": "<string>",
      "plausibleAnalytics": "<string>"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.letterby.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

apiKey
string
header
required

API key to authorize requests

Body

application/json
name
string
required

List name

url
string
required

List handle

desc
string

Short description

Response

List created successfully

data
object