# Create a new social template as a digital asset

Create a new social template as a part of the Digital Asset Management (DAM) framework.

Endpoint: POST /social-templates
Version: 20250708

## Request fields (*/*):

  - `title` (string)

  - `description` (string)

  - `photos` (array)

  - `photos.photo` (object)
    Placeholder to represent photo for a social post which can either be a base64 encoded string or a S3 link for image

  - `photos.description` (string)
    Description for the social post photo

  - `photos.redirectUrl` (string)
    The URL that a user is redirected to when clicking the photo

  - `videos` (array)

  - `directories` (array)

  - `url` (string)

  - `isStoreLocator` (boolean)

  - `callToActions` (array)

  - `callToActions.url` (string)
    The url of the call to action.

  - `callToActions.type` (string)
    The type of the call to action.
    Enum: "CALL", "LEARN_MORE", "SIGN_UP", "DIRECTIONS", "WEBSITE", "BOOK_TRAVEL", "INSTALL_APP", "LISTEN_MUSIC", "NO_BUTTON", "USE_APP", "WATCH_MORE", "WATCH_VIDEO", "DOWNLOAD", "BOOK", "ORDER", "SHOP"

  - `callToActions.directory` (string)
    The directory of the call to action.
    Enum: "FACEBOOK", "GOOGLE", "APPLE_MAPS", "LINKED_IN"

  - `asset` (object)
    DAM Asset Model

  - `asset.name` (string)
    Name of the DAM Asset

  - `asset.description` (string)
    Description of the DAM Asset

  - `asset.type` (string)
    Type of the DAM Asset that should be SOCIAL_POST_TEMPLATE

  - `asset.status` (string)
    Status of the DAM Asset that can be VISIBLE or HIDDEN

  - `asset.startDate` (string)
    Start date of the DAM Asset

  - `asset.endDate` (string)
    End date of the DAM Asset

  - `asset.allManagedResources` (boolean)
    Set to true if the Asset should be visible to all managed locations of the user

  - `asset.locationIds` (array)
    Location IDs of the DAM Asset

  - `asset.businessIds` (array)
    Business IDs of the DAM Asset

  - `asset.excludedLocationIds` (array)
    Excluded location IDs of the DAM Asset

  - `asset.labels` (array)
    Labels of the DAM Asset

  - `asset.locationGroupIds` (array)
    Location Group IDs of the DAM Asset

  - `asset.folderId` (integer)
    Folder ID where the DAM asset should be created

## Response 200 fields (*/*):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `warnings` (array)
    (optional) Holds further warnings

  - `response` (object, required)
    The actual response object of the response

  - `response.socialPostTemplate` (object)
    Social Post Template Model

  - `response.socialPostTemplate.title` (string)
    The title of the Social Post Template.

  - `response.socialPostTemplate.description` (string)
    The description of the Social Post Template. It is required if the template has no photos.

  - `response.socialPostTemplate.url` (string)
    A link for the Social Post Template.

  - `response.socialPostTemplate.type` (string, required)
    The type of the Social Post Template. POST, OFFER or QUESTION_AND_ANSWER, EVENT or ALERT.
    Enum: "POST", "OFFER", "ALERT", "EVENT", "QUESTION_AND_ANSWER", "REEL", "STORY", "CAROUSEL"

  - `response.socialPostTemplate.alertType` (string)
    Set to COVID_19 if this Social Post Template is a COVID-19 Google Alert Post
    Enum: "COVID_19"

  - `response.socialPostTemplate.id` (integer)
    Id

  - `response.socialPostTemplate.shared` (boolean)
    Defines if the Social Post Template is shared or not.

  - `response.socialPostTemplate.isStoreLocator` (boolean)
    When enabled, the SocialPost will be visible in StoreLocator

  - `response.socialPostTemplate.callToActions` (array)
    Social Post Call to Action Description (URL & Type)

  - `response.socialPostTemplate.callToActions.url` (string)
    The url of the call to action.

  - `response.socialPostTemplate.callToActions.type` (string)
    The type of the call to action.
    Enum: "CALL", "LEARN_MORE", "SIGN_UP", "DIRECTIONS", "WEBSITE", "BOOK_TRAVEL", "INSTALL_APP", "LISTEN_MUSIC", "NO_BUTTON", "USE_APP", "WATCH_MORE", "WATCH_VIDEO", "DOWNLOAD", "BOOK", "ORDER", "SHOP"

  - `response.socialPostTemplate.callToActions.directory` (string)
    The directory of the call to action.
    Enum: "FACEBOOK", "GOOGLE", "APPLE_MAPS", "LINKED_IN"

  - `response.socialPostTemplate.asset` (object)
    Dam Asset Model

  - `response.socialPostTemplate.asset.name` (string)
    Name

  - `response.socialPostTemplate.asset.description` (string)
    Description

  - `response.socialPostTemplate.asset.dateCreated` (string)
    The date when the asset was created

  - `response.socialPostTemplate.asset.dateUpdated` (string)
    The date when the asset was last updated

  - `response.socialPostTemplate.asset.status` (string)
    Status of the asset
    Enum: "HIDDEN", "VISIBLE", "REMOVED"

  - `response.socialPostTemplate.asset.type` (string)
    Type of the asset
    Enum: "AD_TEMPLATE", "SOCIAL_POST_TEMPLATE"

  - `response.socialPostTemplate.asset.authorId` (integer)
    The author of the asset

  - `response.socialPostTemplate.asset.folderId` (integer)
    The folder id where the asset is stored

  - `response.socialPostTemplate.asset.locationIds` (array)
    List of location Ids

  - `response.socialPostTemplate.asset.businessIds` (array)
    List of business ids

  - `response.socialPostTemplate.asset.excludedLocationIds` (array)
    List excluded location Ids

  - `response.socialPostTemplate.asset.labels` (array)
    List of labels

  - `response.socialPostTemplate.userId` (integer, required)
    Id of the user that is doing the action

  - `response.socialPostTemplate.photos` (array)
    The Social Post Template's photos. It should be a list containing BASE64 converted images or urls of photos from a previous Social Post. It is required if the template has no description.

  - `response.socialPostTemplate.photos.photo` (object)
    Placeholder to represent photo for a social post which can either be a base64 encoded string or a S3 link for image

  - `response.socialPostTemplate.photos.description` (string)
    Description for the social post photo

  - `response.socialPostTemplate.photos.redirectUrl` (string)
    The URL that a user is redirected to when clicking the photo

  - `response.socialPostTemplate.videos` (array)
    List of videos (currently only supports one element)

  - `response.socialPostTemplate.directories` (array)
    Enum: "FOURSQUARE", "UBER", "GOOGLE", "WAZE", "GOOGLE_MAPS", "YELP", "YELP_API", "MEINESTADT", "YELLOW_MAP", "FOCUS", "LOKALEAUSKUNFT", "WEB_DE", "GMX", "ONE_AND_ONE", "FREIEAUSKUNFT", "POINTOO", "NOKIA_HERE", "FACEBOOK", "TOMTOM", "STADTBRANCHENBUCH", "CYLEX", "UNTERNEHMENSAUSKUNFT", "ACOMPIO", "BUSINESSBRANCHENBUCH", "YALWA", "THE_PHONEBOOK", "SCOOT", "CENTRAL_INDEX", "CITIPAGES", "ONE_NINE_TWO", "ONE_ONE_EIGHT", "THE_DAILY_RECORD", "THE_EVENING_STANDARD", "THE_SCOTSMAN", "LIVERPOOL_ECHO", "THE_SUN", "THE_INDEPENDENT", "TOUCH_LOCAL", "THE_MIRROR", "ANNUAIRE", "INFOBEL", "US_INFO_COM", "GARMIN", "FACTUAL", "BING", "WO_GIBTS_WAS", "KOOMIO", "ABCLOCAL", "YELLBO", "JELLOO", "GUIDELOCAL", "OEFFNUNGSZEITENBUCH", "APPLE_MAPS", "LOOCAL", "REGIONAL_DE", "WHERE_TO", "TUPALO", "GELBE_SEITEN", "DAS_OERTLICHE", "DIALO", "BUNDES_TELEFONBUCH", "BRANCHENBUCH_DEUTSCHLAND", "MARKTPLATZ_MITTELSTAND", "BUSQUEDA_LOCAL", "RICERCARE_IMPRESE", "PAGES24", "NAVMII", "AUDI", "BMW", "MERCEDES", "VW", "TOYOTA", "FORD", "FIAT", "GM", "ETRUSTED", "INSTAGRAM", "SHOPPING_TIME_NETWORK", "CITY_SQUARES", "SHOWMELOCAL", "LOCALSTACK", "CHAMBER_OF_COMMERCE", "JUDYS_BOOK", "BROWNBOOK", "MY_LOCAL_SERVICES", "YA_SABE", "UNIVISION", "AL_DIA_TX", "LA_VOZ_TX", "CHRON", "STATESMAN", "PALM_BEACH_POST", "MUNDO_HISPANICO", "EL_TIEMPO_LATINO", "LATINOS_US", "HOTFROG", "INFO_IS_INFO", "MANTA", "US_CITY", "GO_YELLOW", "N49", "PRATIQUE", "JUSTACOTE", "EZLOCAL", "ELOCAL", "TRUE_LOCAL", "START_LOCAL", "WOMO", "AUSSIE_WEB", "YELLOW_PAGES", "SUPER_PAGES", "WHITE_PAGES", "DEX_KNOWS", "KAUFDA_MANUAL", "I_GLOBAL", "BRANCHEN_INFO_MANUAL", "GUTE_BANKEN_MANUAL", "D_11880_COM_MANUAL", "BANKOEFFNUNGSZEITEN_DE_MANUAL", "BANK_OEFFNUNGSZEITEN_DE_MANUAL", "CYLEX_MANUAL", "FINDE_OFFEN_MANUAL", "MEIN_PROSPEKT_MANUAL", "DAS_SCHNELLE", "SENSIS_WHITE_PAGES", "SENSIS_TRUE_LOCAL", "SENSIS_YELLOW_PAGES", "FIND_OPEN", "WAND", "BELL_CA", "GO_LOCAL", "MEINUNGSMEISTER", "YANDEX", "YAHOO_MANUAL", "HOLIDAY_CHECK", "TRIP_ADVISOR", "BONIAL_FR", "ZIP_CH", "PAGES_JAUNES", "YELLOW_PAGES_SINGAPORE", "INFOGROUP", "WAZE_NEW", "UBER_NEW", "NEUSTAR", "TRUSTPILOT", "AUSKUNFT", "BAIDU", "NEXT_DOOR", "MICROSOFT_CORTANA", "GOOGLE_ASSISTANT", "CBANQUE", "ORANGE_118_712", "SIRI", "HUAWEI", "DOCTOR_COM", "CARE_DASH", "DENTAL_PLANS", "DOC_SPOT", "HEALTHGRADES", "SHARE_CARE", "VITALS", "WEB_MD", "WELLNESS", "ZOC_DOC", "ZWIVEL", "YP_COM_HEALTH", "BING_HEALTH", "NPPES", "RATE_MDS", "CITYSEARCH", "INSIDER_PAGES", "TWITTER", "ALEXA", "MAP_QUEST", "WEBSITE_WIDGETS", "ECO_MOVEMENT", "GOOGLE_EV", "APPLE_EV", "TESLA_EV", "EUROWAG_EV", "OPIS_EV", "TOMTOM_EV", "HERE_EV", "YELLOW_PAGES_CANADA", "BBB", "UBERALL_SOCIAL_ADS", "APPLE_APPS", "CONSUMER_AFFAIRS", "CREDIT_KARMA", "DELIVERY", "GLASSDOOR", "PLAY_GOOGLE", "GRUBHUB", "INDEED", "LENDING_TREE", "MENUISM", "OPEN_TABLE", "OPEN_TABLE_USA", "WALLET_HUB", "ZILLOW", "ZOMATO", "WHATS_APP", "FOUR_SCREEN", "AND_CHARGE", "LINKED_IN"

  - `response.socialPostTemplate.ownerId` (integer)
    The id of the user that owns the Social Post Template. (Only informational. If included in the request, it will be ignored.)

  - `response.socialPostTemplate.ownerName` (string)
    The name of the user that owns the Social Post Template. (Only informational. If included in the request, it will be ignored.)

## Response 400 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response

## Response 403 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response

## Response 404 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response

## Response 409 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response