Uberall API (20250204)

Enhance your application with Uberall's comprehensive API documentation

Download OpenAPI description
Languages
Servers
Mock server

https://docs.uberall.com/_mock/apis/swagger/

https://uberall.com/api/

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

Update SSO Settings of a SalesPartner

Request

Can be used to update certain SSO settings for a single SalesPartner.

Path
idstringrequired

ID of the SalesPartner

Body*/*

Flag to indicate if single sign-on should be enforced. If enforced, users are allowed to log in via the single sign-on flow. Furthermore, the User's details such as name, email, feature, and others will be updatable via single sign-on only

forceSsoboolean
curl -i -X PATCH \
  'https://docs.uberall.com/_mock/apis/swagger/sales-partners/{id}/sso-settings' \
  -H 'Content-Type: */*' \
  -H 'accessToken: YOUR_API_KEY_HERE' \
  -d '[object Object]'

Responses

Successfully edited SalesPartner SSO settings

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.​salesPartnerobject

Sales Partner Model

Response
No content

Search among child SalesPartners

Request

Can be used for searching through all children SalesPartner for the given parent SalesPartner

Query
idstring

Filter by specific uberall SalesPartner id

querystring

Filter by name or identifier

statusstring

Filter by status

sortstring

SalesPartner property used for pagination. Default: 'id'

orderstring

Order used for pagination. Default: 'asc'

maxinteger(int64)

Used for pagination. Maximum number of results per page. Default: 1000

offsetinteger(int64)

Offset used for pagination. Default: 0

curl -i -X GET \
  'https://docs.uberall.com/_mock/apis/swagger/sales-partners?id=string&max=0&offset=0&order=string&query=string&sort=string&status=string' \
  -H 'accessToken: YOUR_API_KEY_HERE'

Responses

Successfully retrieved all child SalesPartners

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.​countinteger(int32)

The total count of found children

Example: 6
response.​pageCountinteger(int32)

The number of children on the current page

Example: 6
response.​maxinteger(int32)

The maximum number of results to return

Example: 10
response.​offsetinteger(int32)

The offset for pagination

Example: 0
response.​childrenArray of objects(SalesPartnerResponseModel)
Example: [{"id":270,"identifier":null,"name":"Dreamscape Networks FZ-LLC","privateKey":"c1Y3fRvwe0GHVEH5eM4TDZxousDwykwhv1lDRIhSeHAEVp5pLWiWdkbN3pJjwGBRATpQzXlh8MhIoYTaRX3MuyoDJBYHDwI3gJJIOjZX0KCGQj7HCdy7WEsc2Z66aFaD","status":"APPROVED"},{"id":464,"identifier":null,"name":"Touch Local Ltd","privateKey":"bWSWLIjiwIlUeToEeqvt8mS4DfSil5td9Lb06Xqbnmm5Z62cXTEAtN4UIG0pUtOr","status":"APPROVED"},{"id":3518,"identifier":null,"name":"Test Account","privateKey":"grB76Xs3qRBknUWvMoMHirTY8wfSJ2ipLyxX2rTBw63QCs45M6hh9DB5F8vBNgIFDoytsziYF8pA6XokCrVCqaOFzz5VR7Nj1W5sUWnpYXQdk1hLswvJrh2FIqIv2667","status":"APPROVED"},{"id":3519,"identifier":null,"name":"Web.com","privateKey":"zU2peIsy4VJGMuEnNmCdNfawF5hyQdw9pNk7sIdibljeAafuqjKFCb81yiyUcMfN9fstjpKFniRow6E5VGHWAB3rwJtY697PoFpnplPKnmhJaLoZlVpj2i7yzHhWVGhV","status":"APPROVED"},{"id":3763,"identifier":null,"name":"Network Solutions","privateKey":"sQwJtLBRPi3vV978gDyydnUx8YQsGRKvih3BI6Zcr965BTQ3GSM4LmJTenZChqZnPbJ6tY85Li5GEUnQAgAJf3JYarhu2i5lnWmY9mNG9MWSxVOhIrGk2dEvineVhyGO","status":"APPROVED"},{"id":3764,"identifier":null,"name":"Register.com","privateKey":"wsISftqTjOOdoPlz3b7elRN7pFW20tLs8nWRubmUScRWr0dfyxUmLAGpTXPwMeOkuRl2Y590R39cTUoPSuzVGTerLAaYkib7jjB5gTOtk0y3hvlPpyARHPW6NosApUOk","status":"APPROVED"}]
Response
No content

Create child SalesPartner

Request

Can be used to create new child SalesPartner that will be then associated to your parent SalesPartner.

Bodyapplication/jsonrequired

SalesPartner data to create a new child SalesPartner

addressstringrequired

Full address string of the new child SalesPartner (Be aware: Can't be NULL or empty)

aggregateInvoicesToParentboolean

Indicates if the invoice for this SalesPartner should be aggregated to the parent invoice

attributionobject

Attribution Model

canSeePricesboolean

Indicates if the child SalesPartner should be allowed to see price information for e.g. product plans

countrystring

Country of the new child SalesPartner

Enum"AF""AX""AL""DZ""AS""AD""AO""AI""AQ""AG"
emailAccountingstring

Accounting email of the new child SalesPartner

emailCustomerSupportstring

Customer support email of the new child SalesPartner

emailProjectLeadstring

Project lead email of the new child SalesPartner

identifierstring

Identifier of the new child SalesPartner (e.g. your own customer ID for better reference)

minPasswordLengthinteger(int32)

Minimum password length for all users of the new child SalesPartner

namestringrequired

Name of child SalesPartner (Be aware: Can't be NULL or empty)

parentinteger(int64)required

Parent ID of the associated parent SalesPartner. (Be aware: You need the Uberall SalesPartner ID of the parent)

phonestring

Phone number of the new child SalesPartner

preferredLanguageobject

Preferred language of the new child SalesPartner, for invoice purpose (either 'de' oder 'en')

salesPartnerStatusstring

Sales Partner Status Enum

Enum"CREATED""APPROVED""DECLINED""DELETED""INACTIVE"
vatIdstring

VAT (Value-Added Tax) ID number of the SalesPartner (e.g. for Germany: DE123456789)

curl -i -X POST \
  https://docs.uberall.com/_mock/apis/swagger/sales-partners \
  -H 'Content-Type: application/json' \
  -H 'accessToken: YOUR_API_KEY_HERE' \
  -d '{
    "address": "string",
    "aggregateInvoicesToParent": true,
    "attribution": {
      "name": "string",
      "url": "string",
      "id": 0,
      "logo": {
        "url": "string",
        "type": "LOGO",
        "description": "string"
      }
    },
    "canSeePrices": true,
    "country": "AF",
    "emailAccounting": "string",
    "emailCustomerSupport": "string",
    "emailProjectLead": "string",
    "identifier": "string",
    "minPasswordLength": 0,
    "name": "string",
    "parent": 0,
    "phone": "string",
    "preferredLanguage": {},
    "salesPartnerStatus": "CREATED",
    "vatId": "string"
  }'

Responses

Successfully created child SalesPartner

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.​salesPartnerobject

Sales Partner Model

Response
No content

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 Points

Products - Data Points

Operations

Data Point Filters

Products - Data Points - Data Point Filters

Operations

Templates

Products - Response Library - Templates

Operations

Social Posting

Products - Social Posting

Operations

Social Posting Templates

Products - Social Posting - Social Posting Templates

Operations

Digital Asset Management

Products - Digital Asset Management

Operations

Status Check

Products - Status Check

Operations

Store Finder

Products - Store Finder

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