Publique e agende em 13 redes com uma só API REST. Leia análises, responda comentários e DMs e receba um webhook assinado assim que um post vai ao ar, falha ou é aprovado.
Authorization: Bearer YOUR_API_KEY {"content":"Our autumn menu lands on Friday.","social_profile_ids":[101,102],"publish_time":"2026-11-27T09:00","timezone":"America/New_York","status":"scheduled"}
{"id":18342,"status":"scheduled","publish_time":"2026-11-27T09:00:00-05:00","timezone":"America/New_York","social_profiles":[{"name":"Northwind Instagram","platform":"instagram","status":"pending"},{"name":"Northwind LinkedIn","platform":"linkedin","status":"pending"}]}
X-RobinReach-Event: post.published X-RobinReach-Signature: t=1794150000,v1=5257a869e7… {"id":"evt_1c626cf6bcb5","type":"post.published","data":{"post":{"id":18342,"status":"published","summary":{"total":2,"published":2,"failed":0}}}}
Uma troca de exemplo com IDs inventados. Os webhooks chegam como um POST assinado no seu endpoint HTTPS.
Envie o texto, os perfis e o horário. O RobinReach confere o post com as regras de cada rede, coloca no calendário e publica na hora certa.
GET /api/v1/social_profiles para obter os IDs das contas em que você quer publicar.timezone que você passar, então 09:00 quer dizer 9:00 para o seu público.Não tem certeza se um post vai passar? POST /api/v1/posts/validate faz as mesmas verificações sem salvar nada.
curl -X POST https://robinreach.com/api/v1/posts \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "content": "Our autumn menu lands on Friday.", "social_profile_ids": [ 101, 102 ], "publish_time": "2026-11-27T09:00", "timezone": "America/New_York", "status": "scheduled" }'
require "net/http" require "json" uri = URI("https://robinreach.com/api/v1/posts") request = Net::HTTP::Post.new(uri, "Authorization" => "Bearer YOUR_API_KEY", "Content-Type" => "application/json") request.body = { content: "Our autumn menu lands on Friday.", social_profile_ids: [101, 102], publish_time: "2026-11-27T09:00", timezone: "America/New_York", status: "scheduled" }.to_json response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) } puts response.body
const response = await fetch("https://robinreach.com/api/v1/posts", { method: "POST", headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ content: "Our autumn menu lands on Friday.", social_profile_ids: [101, 102], publish_time: "2026-11-27T09:00", timezone: "America/New_York", status: "scheduled", }), }); console.log(await response.json());
import requests response = requests.post( "https://robinreach.com/api/v1/posts", headers={"Authorization": "Bearer YOUR_API_KEY"}, json={ "content": "Our autumn menu lands on Friday.", "social_profile_ids": [101, 102], "publish_time": "2026-11-27T09:00", "timezone": "America/New_York", "status": "scheduled", }, timeout=30, ) print(response.json())
A API cobre o trabalho que sua equipe faz no painel, para que o seu código também possa fazer.
Crie, valide, publique na hora, reagende e apague posts, com as opções próprias de cada rede, ligados a uma ideia quando vêm de uma.
/posts/posts/validate/posts/{id}/posts/{id}/publish_now/posts/{id}/rescheduleListe, adicione, edite e arquive as ideias de posts da marca, e escreva novas com a IA do RobinReach.
/ideas/ideas/generate/ideas/{id}Envie imagens, vídeos e PDFs, organize em pastas e reutilize nos posts.
/attachments/attachments/{id}/folders/folders/{id}Liste as marcas e os perfis conectados, além de pastas do Pinterest, áudios do Instagram, categorias e tags do WordPress, locais e grupos de hashtags.
/brands/brands/{id}/social_profiles/social_profiles/{id}/social_profiles/{id}/pinterest_boards/locations/hashtag_groupsO engajamento por perfil e por post, seus melhores posts, esta semana contra a anterior e o calendário.
/analytics/summary/analytics/top_posts/posts/{id}/analytics/social_profiles/{id}/analytics/calendarLeia as conversas de comentários, as DMs do Facebook e do Instagram e as avaliações do Google dos seus perfis, e responda como a marca.
/comment_threads/comment_threads/{id}/replyCrie, pause e retome automações de Comment to DM, feeds RSS e tarefas de reaproveitamento. Confira um feed antes de adicionar e rode uma tarefa quando quiser.
/comment_automations/comment_automations/{id}/pause/rss_feeds/rss_feeds/validate/rss_feeds/{id}/sync/repurposing_tasks/repurposing_tasks/{id}/runEdite a página bio da marca e os blocos dela, coloque-os em ordem, leia as análises da página e pegue o QR code.
/bio_page/bio_page/blocks/bio_page/blocks/{id}/bio_page/blocks/reorder/bio_page/analytics/bio_page/qrCom os Connect Links os clientes adicionam as próprias contas. Com os Approval Links eles revisam posts sem fazer login.
/connect_links/connect_links/{id}/approval_links/approval_links/{id}/posts/{id}/approve/posts/{id}/rejectAdicione endpoints, envie eventos de teste, troque os segredos de assinatura e leia o registro de entregas.
/webhook_endpoints/webhook_endpoints/{id}/webhook_endpoints/{id}/test/webhook_endpoints/{id}/rotate_secret/webhook_endpoints/{id}/enable/webhook_endpoints/{id}/deliveriesAdicione um endpoint HTTPS e o RobinReach envia um POST assinado para os eventos que você escolher. Avise sua equipe, sincronize seu CRM ou responda um comentário ou uma DM no segundo em que chega.
post.publishedUm post foi publicado em todos os perfis selecionados.post.partially_publishedUm post foi publicado em alguns perfis e falhou em outros.post.failedUm post falhou em todos os perfis selecionados, com o motivo de cada um.post.approvedUm post foi aprovado no painel ou por um Approval Link.post.rejectedUm post foi recusado, com a observação de quem revisou.comment.receivedOutra pessoa comentou em um perfil conectado. As suas próprias respostas nunca disparam esse evento.review.receivedChegou uma avaliação nova no Perfil da Empresa no Google.message.receivedAlguém enviou uma mensagem direta para uma Página do Facebook ou conta do Instagram conectada.Até 10 endpoints por marca. Com a chave mestra, um endpoint na sua marca padrão pode ouvir todas as marcas de uma vez.
{
"id": "evt_1c626cf6bcb54613a8053e24d5361527",
"type": "post.published",
"created_at": "2026-11-27T14:00:00Z",
"api_version": "2026-11-01",
"data": {
"brand": {
"id": "northwind",
"name": "Northwind Coffee"
},
"post": {
"id": 18342,
"status": "published",
"content": "Our autumn menu lands on Friday.",
"social_profiles": [
{
"id": 101,
"platform": "instagram",
"status": "published",
"remote_url": "https://www.instagram.com/p/C9xYz12AbCd/"
},
{
"id": 102,
"platform": "linkedin",
"status": "published",
"remote_url": "https://www.linkedin.com/feed/update/urn:li:share:7392018841650188288/"
}
],
"summary": {
"total": 2,
"published": 2,
"failed": 0
}
}
}
}
Cada requisição traz X-RobinReach-Signature: t=…,v1=…, um HMAC-SHA256 do horário e do corpo bruto, assinado com o segredo do seu endpoint. Confira antes de confiar no conteúdo e rejeite horários com mais de cinco minutos.
class RobinreachWebhooksController < ActionController::API def create body = request.raw_post return head :unauthorized unless valid_signature?(body, request.headers["X-RobinReach-Signature"]) event = JSON.parse(body) # Skip event["id"] if you have seen it, then queue the work. head :ok end private def valid_signature?(body, header, tolerance: 300) parts = header.to_s.split(",").map { |p| p.split("=", 2) }.select { |kv| kv.size == 2 }.to_h t = Integer(parts["t"].to_s, exception: false) return false unless t && parts["v1"] && (Time.now.to_i - t).abs <= tolerance expected = OpenSSL::HMAC.hexdigest("SHA256", ENV.fetch("ROBINREACH_WEBHOOK_SECRET"), "#{t}.#{body}") ActiveSupport::SecurityUtils.secure_compare(expected, parts["v1"]) end end
import crypto from "node:crypto"; import express from "express"; const app = express(); app.post("/webhooks/robinreach", express.raw({ type: "application/json" }), (req, res) => { const raw = req.body.toString("utf8"); if (!verify(raw, req.get("X-RobinReach-Signature"), process.env.ROBINREACH_WEBHOOK_SECRET)) { return res.sendStatus(401); } const event = JSON.parse(raw); // Skip event.id if you have seen it, then queue the work. res.sendStatus(200); }); function verify(rawBody, header, secret, toleranceSec = 300) { const parts = Object.fromEntries((header || "").split(",").map((p) => p.split("=", 2))); const t = Number(parts.t); if (!t || !parts.v1 || Math.abs(Date.now() / 1000 - t) > toleranceSec) return false; const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex"); const a = Buffer.from(expected), b = Buffer.from(parts.v1); return a.length === b.length && crypto.timingSafeEqual(a, b); }
import hashlib, hmac, os, time from flask import Flask, request, abort app = Flask(__name__) @app.post("/webhooks/robinreach") def robinreach_webhook(): raw = request.get_data() if not verify(raw, request.headers.get("X-RobinReach-Signature", ""), os.environ["ROBINREACH_WEBHOOK_SECRET"]): abort(401) event = request.get_json() # Skip event["id"] if you have seen it, then queue the work. return "", 200 def verify(raw_body, header, secret, tolerance=300): parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p) try: t = int(parts["t"]) except (KeyError, ValueError): return False if "v1" not in parts or abs(time.time() - t) > tolerance: return False expected = hmac.new(secret.encode(), f"{t}.".encode() + raw_body, hashlib.sha256).hexdigest() return hmac.compare_digest(expected, parts["v1"])
Uma entrega com falha é tentada de novo 7 vezes ao longo de cerca de 28 horas, com intervalos cada vez maiores.
Depois de 10 entregas com falha seguidas, o endpoint pausa e o administrador da marca recebe um e-mail. Retome com um clique.
Cada evento tem um ID único, para o seu código poder ignorar a rara duplicata.
Cada tentativa, código de status e corpo de resposta fica guardado por 30 dias, e você pode enviar um evento de teste quando quiser.
https://robinreach.com/api/v1. Todos os caminhos desta página são relativos a ela.Authorization: Bearer YOUR_API_KEY. Um parâmetro api_key na URL também funciona, mas pode parar nos logs do servidor, então prefira o cabeçalho.brand_id. Uma chave de marca alcança uma só marca, então dá para entregá-la com segurança a um cliente ou a uma ferramenta com uma única função.America/New_York, ou no fuso da marca se você não passar nenhum.401 para chave ausente ou errada, 404 para tudo o que está fora do alcance da chave, 422 com uma mensagem clara quando um post quebra as regras de uma rede.429 com os cabeçalhos Retry-After e X-RateLimit-*, para o seu cliente desacelerar sozinho./api/v1, e cada webhook informa a versão do conteúdo em api_version.Cada rede mantém as próprias opções, como Reels do Instagram, títulos do YouTube, pastas do Pinterest ou posts de documento do LinkedIn, definidas por post em platform_options.
Dê aos seus usuários publicação em 13 redes sem construir nem manter a API de cada rede.
Cuide de cada marca cliente a partir de uma conta, com uma chave de marca e webhooks próprios para cada cliente.
Transforme produtos, anúncios, artigos ou eventos novos em posts agendados assim que eles existem.
Mande posts com falha para o Slack, leve os resultados para o seu CRM e traga as análises para os seus próprios painéis.
O Claude, o ChatGPT, o Cursor e os seus próprios agentes recebem as mesmas ações como ferramentas, com uma URL e a mesma chave.
Ver o servidor MCPInstale o n8n-nodes-robinreach e agende posts a partir de qualquer fluxo do n8n.
Ver no GitHubChame a API a partir de uma etapa de webhook no Zapier ou de um módulo HTTP no Make. A página Integrações tem as configurações prontas para copiar.
Abrir IntegraçõesAuthorization: Bearer YOUR_API_KEY. Um parâmetro api_key na URL também funciona, mas o cabeçalho mantém a chave fora dos logs do servidor.brand_id. Cada marca também pode ter a própria chave de marca, que só funciona nela: não precisa de brand_id, não vê as suas outras marcas e não pode criar nem apagar marcas.POST /api/v1/posts com o content, os social_profile_ids, um publish_time em ISO 8601, um timezone como America/New_York e status como scheduled. Chame antes POST /api/v1/posts/validate para conferir com as regras de cada rede sem salvar.t e v1 do cabeçalho X-RobinReach-Signature, calcule um HMAC-SHA256 de t.raw_body com o seu segredo de assinatura e compare os dois em tempo constante. Rejeite horários com mais de cinco minutos. Os exemplos acima fazem isso em Ruby, Node e Python.GET /api/v1/comment_threads lista as conversas de comentários, as conversas do Facebook e do Instagram e as avaliações do Google, e POST /api/v1/comment_threads/{id}/reply responde uma delas como a marca: embaixo do comentário, em privado numa DM ou publicamente no Google numa avaliação. Combine com os webhooks comment.received e message.received para responder assim que algo chegar./api/v1/ideas lista, adiciona (até 20 de uma vez), edita e exclui ideias com notas, links, etiquetas e arquivos da biblioteca, e POST /api/v1/ideas/generate escreve novas com a IA do RobinReach por um post de IA. Passe idea_id ao criar um post e a ideia acompanha o post no quadro, de Rascunho a Publicado.Gere uma chave, agende um post com uma requisição e adicione um webhook. A referência tem todos os campos.
O acesso à API está incluído nos planos Bloom, Thrive e Scale.