---
updatedAt: 2026-05-13T09:07:33.000Z
---

# Create Text Asset

Create a new Text Content Center Asset

# Details

## Additional Information

### name field

The name field has a character limit of **250**.

If not present, the following defaults will be applied:

* For a Text Asset: the first few words from the `text` will be used
* For an Image Asset: the file name will be used
* For a Video Asset: the file name will be used

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "conversations",
    "version": "1.1"
  },
  "servers": [
    {
      "url": "https://api.spredfast.com/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://example.com/oauth2/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/conversations/asset": {
      "post": {
        "summary": "Create Text Asset",
        "description": "Create a new Text Content Center Asset",
        "operationId": "assets-create-text-asset",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "sfEntityType",
                  "folderId"
                ],
                "properties": {
                  "sfEntityType": {
                    "type": "string",
                    "description": "Specifies that this object is of Khoros Marketing entity type `Asset`. Any other type will fail for this request.",
                    "default": "Asset"
                  },
                  "id": {
                    "type": "string",
                    "description": "The ID of the asset within Khoros Marketing. **readOnly**: true"
                  },
                  "folderId": {
                    "type": "string",
                    "description": "Which folder to place the asset in. This value must be present and a valid."
                  },
                  "name": {
                    "type": "string",
                    "description": "The name of the Asset. See the [Name](#name-field) section below for additional information."
                  },
                  "intendedForPublishing": {
                    "type": "boolean",
                    "description": "Whether the asset can be used for publishing.",
                    "default": true
                  },
                  "intendedForModeration": {
                    "type": "boolean",
                    "description": "Whether the asset can be used for Moderation.",
                    "default": true
                  },
                  "contentLabels": {
                    "type": "array",
                    "description": "List of labels to apply to content generated with this asset.",
                    "items": {
                      "type": "string"
                    }
                  },
                  "services": {
                    "type": "array",
                    "description": "The services to restrict this Asset to. **Allowed Values:** `FACEBOOK`, `INSTAGRAM`, `PINTEREST`, `YOUTUBE`, `VK`, `MULTI_CHANNEL`, `SINAWEIBO`",
                    "items": {
                      "type": "string"
                    }
                  },
                  "startDate": {
                    "type": "string",
                    "description": "The date and time when the asset becomes available for use. **Format**: date-time"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "The date and time when the asset stops being available for use. **Format**: date-time"
                  },
                  "removalDate": {
                    "type": "string",
                    "description": "The date and time when the asset will be removed from Khoros Marketing. **Format**: date-time"
                  },
                  "text": {
                    "type": "string",
                    "description": "Text to go along with the asset. If this is Text Asset, this field is required. **Character Limit**: 4000 **Visible On**: Text asset **Required for**: Text asset"
                  },
                  "image": {
                    "type": "string",
                    "description": "The publicly accessible URL for an Image Asset from within Khoros Marketing Content Center. **Format**: uri **Visible On**: Image asset **readOnly**: true"
                  },
                  "imageMedium": {
                    "type": "string",
                    "description": "The publicly accessible URL for a smaller version of the original Image Asset from within Khoros Marketing Content Center. **Format**: uri **Visible On**: Image asset **readOnly**: true"
                  },
                  "imageThumb": {
                    "type": "string",
                    "description": "The publically accessible URL for a thumbnail of an Image Asset from within Khoros Marketing Content Center. **Format**: uri **Visible On**: Image asset **readOnly**: true"
                  },
                  "video": {
                    "type": "string",
                    "description": "The publically accessible URL for a Video Asset from within Khoros Marketing Content Center. **Format**: uri **Visible On**: Video asset **readOnly**: true"
                  },
                  "videoThumb": {
                    "type": "string",
                    "description": "The publically accessible URL for a thumbnail of a Video Asset from within Khoros Marketing Content Center. **Format**: uri **Visible On**: Video asset **readOnly**: true"
                  },
                  "externalId": {
                    "type": "string",
                    "description": "External ID to represent the ID of the asset outside of the system."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"data\": {\n    \"sfEntityType\": \"Asset\",\n    \"id\": \"84d5cdbe-0f15-415e-80ea-examplede44f\",\n    \"companyId\": \"12\",\n    \"folderId\": \"736\",\n    \"name\": \"Asset Name\",\n    \"text\": \"Asset text value\",\n    \"intendedForPublishing\": true,\n    \"intendedForModeration\": true,\n    \"createdDate\": 1551719642698,\n    \"contentLabels\": [\n      \"coffee - espresso\"\n    ]\n  },\n  \"status\": {\n    \"succeeded\": true\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "sfEntityType": {
                          "type": "string",
                          "example": "Asset"
                        },
                        "id": {
                          "type": "string",
                          "example": "84d5cdbe-0f15-415e-80ea-examplede44f"
                        },
                        "companyId": {
                          "type": "string",
                          "example": "12"
                        },
                        "folderId": {
                          "type": "string",
                          "example": "736"
                        },
                        "name": {
                          "type": "string",
                          "example": "Asset Name"
                        },
                        "text": {
                          "type": "string",
                          "example": "Asset text value"
                        },
                        "intendedForPublishing": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "intendedForModeration": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "createdDate": {
                          "type": "integer",
                          "example": 1551719642698,
                          "default": 0
                        },
                        "contentLabels": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "example": "coffee - espresso"
                          }
                        }
                      }
                    },
                    "status": {
                      "type": "object",
                      "properties": {
                        "succeeded": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "406": {
            "description": "406",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": {\n    \"error\": {\n      \"code\": \"not_acceptable\",\n      \"message\": \"Unable to parse the json you provided.\"\n    },\n    \"succeeded\": false\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "object",
                      "properties": {
                        "error": {
                          "type": "object",
                          "properties": {
                            "code": {
                              "type": "string",
                              "example": "not_acceptable"
                            },
                            "message": {
                              "type": "string",
                              "example": "Unable to parse the json you provided."
                            }
                          }
                        },
                        "succeeded": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```