Update
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/social/settings';const options = { method: 'PATCH', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: 'null'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/social/settings \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullApplies partial changes to the managing entity’s existing managed-social settings and returns the updated configuration.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Update settings for this managing entity
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Partial settings updates
Request to create or update the managed social settings for a managing entity, configuring tone preferences, post types, notification details, posting targets, and content creators.
object
Customization identifier
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Choose the tone of voice to use in text creation.
object
The tone of voice to apply to generated post copy.
Example
NEUTRALRelative weight controlling how often this tone is selected; higher values increase selection probability.
Example
10Example
NEUTRALChoose the post type preferences.
object
The post type this preference applies to.
Example
TRANSACTIONALRelative weight controlling how often this post type is selected; higher values increase selection probability.
Example
10Example
TRANSACTIONALWhether to approve posts and publish automatically.
Example
trueHow many posts to generate and schedule each month. Every generated post beyond the monthly free allowance is billable, so this is the account’s own spend dial. Omit to follow the platform default.
Example
16The name of the email address holder.
Example
Hotel XWhen to post and which language to post in.
object
BCP 47 language code for the language to post in (e.g. en, th, de).
Example
enIANA timezone identifier used to schedule posts in the local time of the target audience (e.g. Asia/Bangkok, America/New_York).
Example
Asia/BangkokExample
{ "language": "en", "timezone": "Asia/Bangkok"}Lets the subscriber choose which content creators get used.
object
The type of content creator persona to use when generating posts.
Example
PROPERTYRelative weight controlling how often this creator type is selected; higher values increase selection probability.
Example
10Example
{ "type": "PROPERTY", "priority": 10}Google Business account ID
Example
google-place-1Example
{ "customizationIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "tones": [ "NEUTRAL" ], "postTypes": [ "TRANSACTIONAL" ], "autoApprove": true, "numberOfPostsPerMonth": 16, "notificationName": "Hotel X", "targets": [ { "language": "en", "timezone": "Asia/Bangkok" } ], "creators": [ { "type": "PROPERTY", "priority": 10 } ], "placeId": "google-place-1"}Responses
Section titled “Responses”Updated managed social settings
Lightweight projection of a managing entity’s managed social media configuration, defining tone, post type preferences, connected platforms, posting targets, and notification settings.
object
Unique identifier for this record.
Datetime this record was first created
Datetime this record was last updated
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.
The user ID that owns the account
The owner entity this entry associates with
Customization identifier
Google Place ID
The email address to send post approval reminders.
The name of the email address holder.
Choose the tone of voice to use in text creation.
object
The tone of voice to apply to generated post copy.
Relative weight controlling how often this tone is selected; higher values increase selection probability.
Choose the post type preferences.
object
The post type this preference applies to.
Relative weight controlling how often this post type is selected; higher values increase selection probability.
Whether to approve posts and publish automatically.
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.
Social network consent entries
object
The social network platform
Current connection status
Sub-accounts (pages, profiles) available through this connection
object
Platform-specific identifier for this sub-account (page, profile, etc)
Display name of the sub-account
Whether this sub-account is currently selected for posting
When to post and which language to post in.
object
BCP 47 language code for the language to post in (e.g. en, th, de).
IANA timezone identifier used to schedule posts in the local time of the target audience (e.g. Asia/Bangkok, America/New_York).
Lets the subscriber choose which content creators get used.
object
The type of content creator persona to use when generating posts.
Relative weight controlling how often this creator type is selected; higher values increase selection probability.
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", "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
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable