Create
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/social/settings';const options = { method: 'POST', 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 POST \ --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 nullCreates the initial managed-social settings for the managing entity and returns the persisted configuration.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Create settings for this managing entity
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters ”Request Body required
Section titled “Request Body required ”Initial managed social settings configuration
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
trueThe 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, "notificationName": "Hotel X", "targets": [ { "language": "en", "timezone": "Asia/Bangkok" } ], "creators": [ { "type": "PROPERTY", "priority": 10 } ], "placeId": "google-place-1"}Responses
Section titled “ Responses ”Newly created managed social settings
Managed social media configuration for a managing entity, defining tone, post type preferences, connected platforms, posting targets, and notification settings.
object
Document UUID
Datetime this record was first created
Datetime this record was last updated
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.
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.
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
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
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