Platforms

Configuraciones de plataforma

Opciones de configuración específicas por plataforma para publicar de forma ajustada en YouTube, TikTok, Pinterest, Instagram, Facebook, LinkedIn y Perfil de Empresa de Google.

Cada plataforma tiene características y configuraciones únicas. Utilice los objetos de configuración a continuación al crear publicaciones para personalizar el comportamiento por plataforma.

TikTok

Parámetro	Tipo	Descripción
`connectionId`OBLIGATORIO	`string`	El id de la cuenta de /social-accounts a la que se aplica esta configuración
`title`	`string`	Título del video (máx. 90 caracteres)
`caption`	`string`	Texto de descripción del video (máx. 2200 caracteres)
`privacyLevel`OBLIGATORIO	`string`	PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY
`allowComments`	`boolean`	Permitir comentarios en el video
`allowDuet`	`boolean`	Permitir duetos
`allowStitch`	`boolean`	Permitir stitches
`sendAsDraft`	`boolean`	Enviar como borrador a la aplicación de TikTok
`aiGenerated`	`boolean`	Marcar como contenido generado por IA
`autoAddMusic`	`boolean`	Añadir música automáticamente al video
`brandedContent`	`boolean`	Marcar como contenido de marca
`brandedContentOwnBrand`	`boolean`	Marcar como promoción de marca propia

Ejemplo

{
  "tiktokConfigs": [{
    "connectionId": "conn_tiktok_001",
    "title": "Product Demo",
    "privacyLevel": "PUBLIC_TO_EVERYONE",
    "allowComments": true,
    "allowDuet": false,
    "aiGenerated": false
  }]
}

YouTube

Parámetro	Tipo	Descripción
`connectionId`OBLIGATORIO	`string`	El id de la cuenta de /social-accounts a la que se aplica esta configuración
`postType`	`string`	VIDEO o SHORTS
`videoTitle`	`string`	Título del video (máx. 100 caracteres)
`tags`	`string[]`	Etiquetas del video para descubrimiento (máx. 20)
`privacyStatus`	`string`	public, unlisted o private
`categoryId`	`string`	ID de categoría de YouTube
`playlistId`	`string`	Agregar a lista de reproducción después de subir
`notifySubscribers`	`boolean`	Notificar a suscriptores (predeterminado: true)
`allowEmbedding`	`boolean`	Permitir incrustación en otros sitios
`madeForKids`	`boolean`	Marcar como contenido para niños
`aiGenerated`	`boolean`	Declara contenido alterado o sintético, como una voz de IA, un avatar de IA o imágenes realistas que se generaron o editaron. YouTube muestra la etiqueta "Contenido alterado o sintético" en el vídeo. Define status.containsSyntheticMedia. Funciona en vídeos y Shorts. Omítelo o envía false para no mostrar la etiqueta.
`license`	`string`	youtube o creativeCommon

Ejemplo

{
  "youtubeConfigs": [{
    "connectionId": "conn_yt_001",
    "postType": "VIDEO",
    "videoTitle": "Weekly Product Update",
    "tags": ["product", "update", "tech"],
    "privacyStatus": "PUBLIC",
    "notifySubscribers": true,
    "allowEmbedding": true,
    "madeForKids": false
  }]
}

Elige el tablero con boardId o boardName. GET /api/v1/social-accounts/:id/pinterest-boards (mira Cuentas sociales) lista el id y el nombre de cada tablero. Un tablero pertenece a una sola cuenta de Pinterest, así que lista los tableros de cada cuenta en la que publicas. Un boardName se busca entre los tableros de la cuenta de esa configuración al procesar la solicitud, y la publicación guarda el id del tablero que coincide; el nombre en sí no se guarda ni se devuelve. Un nombre que no coincide con ningún tablero, o con más de uno, devuelve un 400, y el pin nunca va a otro tablero en su lugar. En una solicitud masiva solo falla ese elemento. Sin boardId ni boardName, el pin va a un tablero público llamado AdaptlyPost, que AdaptlyPost crea en la cuenta de Pinterest la primera vez que hace falta.

Parámetro	Tipo	Descripción
`connectionId`OBLIGATORIO	`string`	El id de la cuenta de /social-accounts a la que se aplica esta configuración
`boardId`	`string`	ID del tablero de Pinterest donde fijar. Pasa boardId o boardName, no los dos. Sin ninguno, el pin va a un tablero público llamado AdaptlyPost
`boardName`	`string`	Nombre del tablero donde fijar, en lugar de boardId. Hasta 180 caracteres. Gana una coincidencia exacta; si no la hay, se usa una única coincidencia sin distinguir mayúsculas y minúsculas. Un nombre que no coincide con ningún tablero o coincide con varios devuelve un 400
`title`	`string`	Título del pin (máx. 100 caracteres)
`link`	`string`	URL de destino al hacer clic en el pin

Ejemplo

{
  "pinterestConfigs": [{
    "connectionId": "conn_pin_001",
    "boardId": "board_123",
    "title": "Summer Collection 2026",
    "link": "https://example.com/summer-collection"
  }]
}

Instagram

Parámetro	Tipo	Descripción
`connectionId`OBLIGATORIO	`string`	El id de la cuenta de /social-accounts a la que se aplica esta configuración
`postType`	`string`	FEED, REEL o STORY. FEED sirve para cualquier tipo de contenido, REEL necesita VIDEO y STORY necesita IMAGE, VIDEO o CAROUSEL; una historia CAROUSEL publica cada elemento como su propia historia, en orden. Cualquier otra combinación devuelve 400. Los videos del feed y los Reels pueden durar hasta 15 minutos
`shareToStory`	`boolean`	Publica también el mismo contenido como historia junto a la publicación FEED o REEL. La historia es su propia entrada en platforms con postType STORY, así que se publica, falla y se reintenta por separado. No lleva texto, primer comentario, portada, colaboradores, prueba ni audio, necesita IMAGE, VIDEO o CAROUSEL, y un video puede durar como máximo 60 segundos. Se ignora cuando postType es STORY
`trialGraduation`	`string`	Publica el reel como reel de prueba, que se muestra primero a quienes no te siguen. MANUAL: lo compartes con tus seguidores en la app de Instagram. SS_PERFORMANCE: Instagram lo comparte si funciona bien. Solo reels de vídeo; omítelo para un reel normal
`collaborators`	`string[]`	Hasta 3 nombres de usuario de Instagram invitados como colaboradores (Instagram Collab). Se quita la @ inicial. Funciona en imágenes del feed, carruseles y reels, no en historias ni reels de prueba. Cada colaborador acepta la invitación en Instagram antes de que la publicación aparezca en su perfil.
`userTags`	`object[]`	Hasta 20 cuentas públicas de Instagram etiquetadas en el contenido, cada una { username, x, y }. Funciona en una sola imagen, un solo vídeo (Reel) o una sola historia, no en carruseles. x e y van de 0 a 1 sobre la imagen, desde la esquina superior izquierda, y cada etiqueta en una imagen del feed necesita ambos. Una historia puede omitirlos, y un vídeo los ignora porque la persona se etiqueta en el vídeo completo. Se quita la @ inicial. Si Instagram rechaza una etiqueta porque la cuenta es privada o no existe, la publicación sale sin etiquetas e instagramUntaggedUsernames lista los usuarios rechazados.
`aiGenerated`	`boolean`	Indica que la publicación se creó o editó con IA. Instagram muestra la etiqueta "Información de IA" en la publicación. Funciona en imágenes, carruseles, reels e historias, y la historia creada con shareToStory también lleva la etiqueta.
`audio`	`InstagramAudio`	Música o un sonido original que se añade al Reel. Necesita contentType VIDEO, un postType distinto de STORY y una cuenta con supportsInstagramAudio: true. Mira Audio de Instagram más abajo

Ejemplo

{
  "contentType": "VIDEO",
  "instagramConfigs": [{
    "connectionId": "conn_ig_001",
    "postType": "REEL",
    "shareToStory": true,
    "collaborators": ["@partnerbrand"],
    "audio": {
      "audioId": "1234567890123456",
      "title": "Summer Nights",
      "artist": "The Example Band",
      "audioVolume": 60,
      "videoVolume": 100
    }
  }]
}

Audio de Instagram

Busca un audioId con GET /api/v1/social-accounts/:id/instagram-audio (mira Cuentas sociales) y pásalo en instagramConfigs[].audio.

Parámetro	Tipo	Descripción
`audioId`OBLIGATORIO	`string`	El audioId de la búsqueda de audio
`title`	`string`	Título de la pista, guardado solo para mostrarlo (máx. 255 caracteres)
`artist`	`string`	Artista o creador, guardado solo para mostrarlo (máx. 255 caracteres)
`audioVolume`	`number`	Volumen del audio añadido, de 1 a 100 (por defecto 100)
`videoVolume`	`number`	Volumen del sonido propio del video, de 1 a 100 (por defecto 100)

Facebook

Parámetro	Tipo	Descripción
`pageId`OBLIGATORIO	`string`	La página de Facebook a la que se aplica esta configuración, tal como se envió en pageIds
`postType`	`string`	FEED, REEL o STORY. FEED sirve para cualquier tipo de contenido, REEL necesita VIDEO y STORY necesita IMAGE, VIDEO o CAROUSEL; una historia CAROUSEL publica cada elemento como su propia historia, en orden. Cualquier otra combinación devuelve 400
`shareToStory`	`boolean`	Publica también el mismo contenido como historia junto a la publicación FEED o REEL. La historia es su propia entrada en platforms con postType STORY, así que se publica, falla y se reintenta por separado. No lleva texto, título de video ni fondo de texto, necesita IMAGE, VIDEO o CAROUSEL, y un video puede durar como máximo 60 segundos. Se ignora cuando postType es STORY
`videoTitle`	`string`	Título para publicaciones de video (máx. 255 caracteres)
`textFormatPresetId`	`string`	Fondo de Facebook para una publicación de texto, como el ID numérico de Facebook (106018623298955 es morado liso). Solo publicaciones TEXT, sin multimedia y de hasta 130 caracteres; cualquier otra cosa devuelve 400. Los enlaces se muestran sin vista previa y, si Facebook rechaza el fondo, la publicación sale como texto simple
`imageLayout`	`string`	GRID (por defecto) muestra varias imágenes como cuadrícula de fotos. CAROUSEL las muestra como tarjetas deslizables, cada una con su propio enlace. Un carrusel necesita de 2 a 5 imágenes, ningún video, postType FEED y una entrada de carouselCards por imagen; cualquier otra cosa devuelve 400
`carouselCards`	`array`	Una tarjeta por imagen, en el mismo orden que el contenido multimedia, usada cuando imageLayout es CAROUSEL. Cada tarjeta tiene link (obligatorio, http o https), title (hasta 100 caracteres) y description (hasta 200). Facebook solo muestra tu imagen y tu título en enlaces a un sitio que pertenece a la página; con cualquier otro enlace la publicación falla y explica por qué

Parámetro	Tipo	Descripción
`connectionId`OBLIGATORIO	`string`	El id de la cuenta de /social-accounts a la que se aplica esta configuración
`documentTitle`	`string`	Título que se muestra en una publicación DOCUMENT (máx. 100 caracteres). Por defecto, el nombre del archivo; se ignora en otros tipos de contenido
`reshareOf`	`string`	Una publicación de LinkedIn que se comparte con el texto de la publicación como comentario: un URN urn:li:share: o urn:li:ugcPost:, o una URL de publicación de LinkedIn que contenga uno, como /feed/update/urn:li:share:7123/ o el enlace para insertar de la publicación (máx. 500 caracteres). En esta cuenta no se adjunta el contenido multimedia; las demás plataformas de la publicación lo siguen recibiendo. Un URN de actividad o una URL /posts/...-activity-... devuelve 400

Ejemplo

{
  "contentType": "DOCUMENT",
  "mediaUrls": ["https://cdn.adaptlypost.com/.../q3-results.pdf"],
  "linkedinConnectionIds": ["conn_li_001"],
  "linkedinConfigs": [{
    "connectionId": "conn_li_001",
    "documentTitle": "Q3 results"
  }]
}

Perfil de Empresa de Google

El Perfil de Empresa de Google acepta publicaciones TEXT o IMAGE con una imagen JPEG o PNG de hasta 5 MB y texto de hasta 1500 caracteres. No tiene texto alternativo. Una ubicación sin configuración publica una actualización STANDARD.

Parámetro	Tipo	Descripción
`connectionId`OBLIGATORIO	`string`	El id de la cuenta de /social-accounts a la que se aplica esta configuración
`topicType`OBLIGATORIO	`string`	STANDARD, EVENT u OFFER. EVENT y OFFER necesitan eventTitle, eventStart y eventEnd
`callToActionType`	`string`	BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP o CALL. CALL usa el número de teléfono del Perfil de Empresa
`callToActionUrl`	`string`	Adónde lleva el botón. Obligatorio para todos los botones excepto CALL
`eventTitle`	`string`	Título del evento o de la oferta
`eventStart`	`string`	Inicio en la hora local del negocio, como YYYY-MM-DD o YYYY-MM-DDTHH:mm, sin zona horaria
`eventEnd`	`string`	Fin en la hora local del negocio, como YYYY-MM-DD o YYYY-MM-DDTHH:mm, sin zona horaria
`offerCouponCode`	`string`	Código de cupón que se muestra en la oferta
`offerRedeemUrl`	`string`	Enlace donde los clientes canjean la oferta
`offerTerms`	`string`	Términos y condiciones de la oferta

Ejemplo

{
  "googleBusinessConfigs": [{
    "connectionId": "conn_gbp_001",
    "topicType": "EVENT",
    "eventTitle": "Live music night",
    "eventStart": "2026-10-16T19:00",
    "eventEnd": "2026-10-16T23:00",
    "callToActionType": "LEARN_MORE",
    "callToActionUrl": "https://example.com/events/live-music"
  }]
}

Tumblr

Parámetro	Tipo	Descripción
`connectionId`OBLIGATORIO	`string`	El id de la cuenta de /social-accounts a la que se aplica esta configuración
`tags`	`string[]`	Hasta 30 etiquetas de hasta 140 caracteres cada una, sin comas. Se elimina el # inicial
`title`	`string`	Encabezado sobre la publicación, hasta 4096 caracteres
`sourceUrl`	`string`	Enlace http o https citado como origen, hasta 2048 caracteres

Ejemplo

{
  "tumblrConfigs": [{
    "connectionId": "conn_tumblr_001",
    "title": "Studio notes, week 12",
    "tags": ["art process", "sketchbook"],
    "sourceUrl": "https://example.com/blog/studio-notes"
  }]
}