Skip to content
API Reference/
/
Create a new social templ...

Uberall API (20250708)

Enhance your application with Uberall's comprehensive API documentation

Download OpenAPI description
swagger.yaml
Overview
URL
https://uberall.com
Support
api@uberall.com
License
Licensed under Uberall
Languages
Servers
https://uberall.com/api/
Mock Server
https://docs.uberall.com/_mock/apis/swagger/

Users

Set up - Users

Operations

Business Connections

Set up - Business Connections

Operations

Businesses

Set up - Businesses

Operations

Configuration

Set up - Configuration

Operations

Sales Partners

Set up - Tenancy - Sales Partners

Operations

Monitoring

Set up - API Status

Operations

Product Plans

Set up - Tenancy - Product Plans

Operations

Webhooks

Set up - Tenancy - Sales Partners - Webhooks

Operations

Auto Response

Products - Auto Response

Operations

Brand Data Points

Products - Brand Data Points

Operations

Dashboard

Products - Analytics - Dashboard

Operations

Dashboard Exports

Products - Analytics - Dashboard Exports

Operations

Data Point Filters

Products - Data Points - Data Point Filters

Operations

Data Points

Products - Data Points

Operations

Digital Asset Management

Products - Digital Asset Management

Operations

Create a new social template as a digital asset

Request

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

Body*/*required

A SocialPostTemplate object that should be created

titlestring
descriptionstring
photosArray of objects
videosArray of strings
directoriesArray of strings
urlstring
isStoreLocatorboolean
callToActionsArray of objects
assetobject

DAM Asset Model

curl -i -X POST \
  https://uberall.com/api/social-templates \
  -H 'Content-Type: */*' \
  -d '[object Object]'

Responses

Social Template created

Body*/*
statusstringrequired
Enum"SUCCESS""QUOTA_LIMIT_EXCEED""NOT_AUTHORIZED""FORBIDDEN""BAD_ACCESS_TOKEN""BAD_PRIVATE_KEY""BAD_PUBLIC_KEY""MISSING_PARAMETER""INVALID_PARAMETER""WRONG_PARAMETER_TYPE"
messagestring

(optional) Holds further information about the response

warningsArray of strings

(optional) Holds further warnings

responseobjectrequired

The actual response object of the response

response.​socialPostTemplateobject

Social Post Template Model

Response
No content

Edit an existing social template

Request

Edit an existing social template identified by its unique uberall ID

Path
idstringrequired

The unique uberall ID for the Social Post Template you want to edit

Body*/*required

A SocialPostTemplate object

titlestring

The title of the Social Post Template.

descriptionstring

The description of the Social Post Template. It is required if the template has no photos.

urlstring

A link for the Social Post Template.

typestringrequired

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"
alertTypestring

Set to COVID_19 if this Social Post Template is a COVID-19 Google Alert Post

Value"COVID_19"
idinteger(int64)

Id

sharedboolean

Defines if the Social Post Template is shared or not.

isStoreLocatorboolean

When enabled, the SocialPost will be visible in StoreLocator

callToActionsArray of objects

Social Post Call to Action Description (URL & Type)

assetobject

Dam Asset Model

ownerIdinteger(int64)

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

directoriesArray of strings
Items Enum"FOURSQUARE""UBER""GOOGLE""WAZE""GOOGLE_MAPS""YELP""YELP_API""MEINESTADT""YELLOW_MAP""FOCUS"
userIdinteger(int64)required

Id of the user that is doing the action

photosArray of objects

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.

videosArray of strings

List of videos (currently only supports one element)

ownerNamestring

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

curl -i -X PATCH \
  'https://uberall.com/api/social-templates/{id}' \
  -H 'Content-Type: */*' \
  -d '[object Object]'

Responses

Social Template updated

Body*/*
statusstringrequired
Enum"SUCCESS""QUOTA_LIMIT_EXCEED""NOT_AUTHORIZED""FORBIDDEN""BAD_ACCESS_TOKEN""BAD_PRIVATE_KEY""BAD_PUBLIC_KEY""MISSING_PARAMETER""INVALID_PARAMETER""WRONG_PARAMETER_TYPE"
messagestring

(optional) Holds further information about the response

warningsArray of strings

(optional) Holds further warnings

responseobjectrequired

The actual response object of the response

response.​socialPostTemplateobject

Social Post Template Model

Response
No content

Near Me Check

Products - Near Me Check

Operations

Social Posting

Products - Social Posting

Operations

Status Check

Products - Status Check

Operations

Store Finder

Products - Store Finder

Operations

Templates

Products - Response Library - Templates

Operations

Batch Operation

Locations Hub - Locations - Batch Operations (excel)

Operations

Categories

Locations Hub - Categories

Operations

Collection Management

Locations Hub - Collections - Collection Management

Operations

Content List

Locations Hub - Collections - Content List

Operations

Locations Data

Locations Hub - Locations Data

Operations

Custom Items

Locations Hub - Collections - Custom Items

Operations

Events

Locations Hub - Collections - Events

Operations

Listings

Locations Hub - Locations - Listings

Operations

Labels

Locations Hub - Labels

Operations

Location Groups

Locations Hub - Location Groups

Operations

Persons

Locations Hub - Locations - Persons

Operations

Locations Photos

Locations Hub - Locations Photos

Operations

Products

Locations Hub - Locations - Product

Operations

Service Items

Locations Hub - Locations - Service Items

Operations

Suggestions

Locations Hub - Locations - Suggestions

Operations

Locations

Locations

Operations