Skip to content

Show

GET
/api/managing-entity/{managingEntityIdentifier}/social/settings
curl --request GET \
--url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/social/settings \
--header 'Authorization: Bearer <token>' \
--header 'Wink-Version: 2.0'

Returns the managed-social settings configured for the given managing entity.

managingEntityIdentifier
required
string
""

Fetch managed social settings for this managing entity

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Managed social settings for the given managing entity

Media typeapplication/json

Lightweight projection of a managing entity’s managed social media configuration, defining tone, post type preferences, connected platforms, posting targets, and notification settings.

object
id

Unique identifier for this record.

string format: uuid
""
createdDate

Datetime this record was first created

string | null format: date-time
""
lastUpdate

Datetime this record was last updated

string | null format: date-time
""
version

Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.

integer | null format: int64
""
userIdentifier
required

The user ID that owns the account

string format: uuid
""
ownerIdentifier
required

The owner entity this entry associates with

string format: uuid
""
customizationIdentifier

Customization identifier

string format: uuid
""
placeId

Google Place ID

string
""
notificationEmail

The email address to send post approval reminders.

string format: email
""
notificationName

The name of the email address holder.

string
""
tones
Array<object>

Choose the tone of voice to use in text creation.

object
type
required

The tone of voice to apply to generated post copy.

string
""
Allowed values: NEUTRAL FRIENDLY LUXURY FOODIE ADVENTUROUS FAMILY ROMANTIC HUMOROUS ECO LOCAL_INSIDER INCLUSIVE BUDGET
priority
required

Relative weight controlling how often this tone is selected; higher values increase selection probability.

integer format: int32
""
postTypes
Array<object>

Choose the post type preferences.

object
type
required

The post type this preference applies to.

string
""
Allowed values: TRANSACTIONAL AWARENESS SENTIMENT
priority
required

Relative weight controlling how often this post type is selected; higher values increase selection probability.

integer format: int32
""
autoApprove

Whether to approve posts and publish automatically.

boolean
numberOfPostsPerMonth

How many posts are generated and scheduled for this account each month. Every post beyond the monthly free allowance is billable. Null means the account follows the platform default.

integer format: int32
"" >= 1 <= 84
connections
Array<object>

Social network consent entries

object
platform
required

The social network platform

string
""
Allowed values: WINK_LINKS FACEBOOK INSTAGRAM
status
required

Current connection status

string
""
Allowed values: ACTIVE DISCONNECTED SUSPENDED
subAccounts
Array<object>

Sub-accounts (pages, profiles) available through this connection

object
id
required

Platform-specific identifier for this sub-account (page, profile, etc)

string
"" >= 1 characters
name
required

Display name of the sub-account

string
"" >= 1 characters
selected

Whether this sub-account is currently selected for posting

boolean
targets
Array<object>

When to post and which language to post in.

object
language
required

BCP 47 language code for the language to post in (e.g. en, th, de).

string
"" >= 1 characters /^[a-z]{2}(-[A-Z]{2})?$/
timezone
required

IANA timezone identifier used to schedule posts in the local time of the target audience (e.g. Asia/Bangkok, America/New_York).

string
"" >= 1 characters
creators
Array<object>

Lets the subscriber choose which content creators get used.

object
type
required

The type of content creator persona to use when generating posts.

string
""
Allowed values: ACTIVITY ADD_ON ATTRACTION FUNNY MEETING_ROOM PLACE PROPERTY ROOM_TYPE RESTAURANT SPA DESTINATION_RELATED USER_SENTIMENT
priority
required

Relative weight controlling how often this creator type is selected; higher values increase selection probability.

integer format: int32
""
key
additional properties
""
Example
{
"id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
"createdDate": "2026-01-14T09:30:00",
"lastUpdate": "2026-02-03T16:45:12",
"version": 3,
"userIdentifier": "c3a9f2e1-8b4d-4c7a-a1e2-5f0b6d9e2c84",
"ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
"customizationIdentifier": "d7e1b4f6-2c8a-4d2b-8f3e-6d9c7b2a0e5f",
"placeId": "place-1",
"notificationEmail": "[email protected]",
"notificationName": "Hotel X",
"tones": [
"NEUTRAL"
],
"postTypes": [
"TRANSACTIONAL"
],
"autoApprove": true,
"numberOfPostsPerMonth": 16,
"connections": [
{
"platform": "FACEBOOK",
"status": "ACTIVE",
"subAccounts": [
{
"id": "page_token_abc1def2ghi3jkl4mno5pqr6stu7vwx",
"name": "The Siam Residences, Bangkok",
"selected": true
}
]
}
],
"targets": [
{
"language": "en",
"timezone": "Asia/Bangkok"
}
],
"creators": [
{
"type": "PROPERTY",
"priority": 10
}
]
}

Bad Request — missing or invalid request parameter or body

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Unauthorized — authentication is required or the session has expired

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Forbidden — authenticated but lacking the required permission or scope

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Not Found — the requested resource does not exist

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Unsupported Media Type — use application/json

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Internal Server Error — an unexpected failure occurred on the server

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Service Unavailable — a downstream dependency is unreachable

Media typeapplication/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example