Skip to content
Wink

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.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Fetch managed social settings for this managing entity

Example 
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Managed social settings for the given managing entity

Media type application/json

Managed social media configuration for a managing entity, defining tone, post type preferences, connected platforms, posting targets, and notification settings.

object
id

Document UUID

string format: uuid
""
createdDate

Datetime this record was first created

string format: date-time
""
lastUpdate

Datetime this record was last updated

string format: date-time
""
version

Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.

integer format: int64
""
userIdentifier
required

The user ID that owns the account

string format: uuid
"" >= 1 characters
ownerIdentifier
required

The owner entity this entry associates with

string format: uuid
"" >= 1 characters
customizationIdentifier
required

Customization identifier

string format: uuid
"" >= 1 characters
placeId

Google Place ID

string
""
notificationEmail
required

The email address to send post approval reminders.

string format: email
"" >= 1 characters
notificationName
required

The name of the email address holder.

string
"" >= 1 characters
tones
required
Array<object>
>= 1 items

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
required
Array<object>
>= 1 items

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
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
required
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
required
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": "f5c9b2d4-0a6b-4e0f-8d1c-6b7a5f0e3c2d",
  "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": "ChIJ82ENKDJgHTERIEjiXbIAAQE",
  "notificationEmail": "[email protected]",
  "notificationName": "The Siam Residences",
  "tones": [
    {
      "type": "NEUTRAL",
      "priority": 10
    },
    {
      "type": "ENTHUSIASTIC",
      "priority": 5
    }
  ],
  "postTypes": [
    {
      "type": "TRANSACTIONAL",
      "priority": 10
    },
    {
      "type": "AWARENESS",
      "priority": 7
    }
  ],
  "autoApprove": false,
  "connections": [
    {
      "platform": "FACEBOOK",
      "status": "ACTIVE",
      "appId": "123456789012345",
      "accessToken": "token_eaa5zx9c2m1p7q3r5s8t9u0v1w2x3y4z",
      "scope": [
        "pages_manage_posts",
        "pages_read_engagement"
      ],
      "expires": "2026-06-15T10:30:00Z",
      "subAccounts": []
    }
  ],
  "targets": [
    {
      "language": "en",
      "timezone": "Asia/Bangkok"
    }
  ],
  "creators": [
    {
      "type": "PROPERTY",
      "priority": 10
    }
  ]
}

400

Section titled “400 ”

Bad Request — missing or invalid request parameter or body

Media type application/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

401

Section titled “401 ”

Unauthorized — authentication is required or the session has expired

Media type application/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

403

Section titled “403 ”

Forbidden — authenticated but lacking the required permission or scope

Media type application/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

404

Section titled “404 ”

Not Found — the requested resource does not exist

Media type application/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

405

Section titled “405 ”

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

Media type application/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

415

Section titled “415 ”

Unsupported Media Type — use application/json

Media type application/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

500

Section titled “500 ”

Internal Server Error — an unexpected failure occurred on the server

Media type application/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

503

Section titled “503 ”

Service Unavailable — a downstream dependency is unreachable

Media type application/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