Skip to main content
POST
/
textItems
Create text items
curl --request POST \
  --url https://api.dittowords.com/v2/textItems \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "project-id",
  "textItems": [
    {
      "text": "Hello world"
    },
    {
      "developerId": "custom-dev-id",
      "text": "Custom ID example",
      "notes": "Shown on the welcome screen",
      "characterLimit": 80
    },
    {
      "text": "{{count}} items in your cart",
      "variables": [
        "count"
      ],
      "plurals": [
        {
          "form": "one",
          "text": "{{count}} item in your cart"
        },
        {
          "form": "other",
          "text": "{{count}} items in your cart"
        }
      ]
    },
    {
      "text": "Hello world",
      "developerId": "localized-greeting",
      "variants": [
        {
          "variantId": "french",
          "text": "Bonjour le monde"
        }
      ]
    }
  ]
}
'
{
  "developerIds": [
    "hello-world",
    "custom-dev-id"
  ]
}

Authorizations

​
Authorization
string
header
required

Body

application/json
​
projectId
string
required

Developer ID of the project the new text items will be added to

​
textItems
object[]
required

Array of new text items to create

Response

200 - application/json

Returns the developer IDs of the created text items

​
developerIds
string[]
required

Array of developer IDs for the created text items