Back to top

Social Post

Overview

Resource Group

Get Social posts of brand

Get Social posts of brand
GET/brands/:brand/social-posts

brand (uuid) ID of the brand

user (uuid) ID of the user (optional)

status (‘executed’ | ‘scheduled’ | ‘draft’ | ‘any’) string (optional)

start (number) number of rows to skip before starting to return rows

limit (number) limited number of records

video (boolean) if the template was video

mediums (Email’ | ‘Social’ | ‘CrmOpenHouse’ | ‘FacebookCover’ | ‘InstagramStory’ | ‘LinkedInCover’ | ‘Letter’ | ‘Website’ | ‘RealtorCover’ | ‘YouTubeCover’ | ‘TwitterCover’)[] array of medium

order (string) eg: -created_at (optional)

Example URI

GET /brands/:brand/social-posts
URI Parameters
HideShow
brand
string (required) Example: d62bfd9f-b8c2-4be6-864e-1d756b5dbac8
status
string (required) Example: executed
associations
string (required) Example: social_post.template_instance,social_post.asset,social_post.owner
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "8455ffab-f4e8-44e5-a888-bb95fa928cfe",
      "brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
      "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "caption": "test",
      "facebook_page": "3e63b0a0-b8d4-4f6f-b322-b97a4e40ad45",
      "template_instance": {
        "id": "ae17e50a-c3ba-4783-8313-c0e8bc43c905",
        "created_at": 1765163642.98539,
        "html": "<div>fakeTemplateInstance</div>",
        "file": {
          "id": "3584c5be-c71b-40c2-9988-38a17ca0ed65",
          "created_at": 1765163643.896974,
          "updated_at": 1765163643.896974,
          "deleted_at": null,
          "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "path": "templates/instances/f3272070-d3e3-11f0-a2d4-1bcac3894d4e.png",
          "name": "image.png",
          "public": true,
          "type": "file",
          "url": "https://test.cloudfront.net/templates/instances/f3272070-d3e3-11f0-a2d4-1bcac3894d4e.png",
          "preview_url": "https://test.cloudfront.net/templates/instances/f3272070-d3e3-11f0-a2d4-1bcac3894d4e.png",
          "mime": "image/png"
        },
        "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "branch": "http://mock-branch-url",
        "updated_at": 1765163642.98539,
        "deleted_at": null,
        "type": "template_instance"
      },
      "asset": null,
      "post_link": "http://test.com",
      "failed_at": null,
      "failure": null,
      "media_container_id": "test",
      "type": "social_post",
      "created_at": 1765163643.979725,
      "updated_at": 1765163643.979725,
      "deleted_at": null,
      "due_at": 1765163043.95,
      "executed_at": 1765163642.98539,
      "owner": {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "current_time": "9:14 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      }
    },
    {
      "id": "ca0cf1b0-9700-4392-b22c-c4ce1601ccb1",
      "brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
      "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "caption": "testAsset",
      "facebook_page": "3e63b0a0-b8d4-4f6f-b322-b97a4e40ad45",
      "template_instance": null,
      "asset": {
        "id": "5d0385d2-0b11-4797-a8bc-cbecf8832db3",
        "created_at": 1765163643.40619,
        "updated_at": null,
        "deleted_at": null,
        "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
        "file": {
          "id": "888544cb-8059-4232-a33e-f30280b00911",
          "created_at": 1765163643.400517,
          "updated_at": 1765163643.400517,
          "deleted_at": null,
          "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "path": "brands/assets/f2db2350-d3e3-11f0-a2d4-1bcac3894d4e.png",
          "name": "logo.png",
          "public": true,
          "type": "file",
          "url": "https://test.cloudfront.net/brands/assets/f2db2350-d3e3-11f0-a2d4-1bcac3894d4e.png",
          "preview_url": "https://test.cloudfront.net/brands/assets/f2db2350-d3e3-11f0-a2d4-1bcac3894d4e.png",
          "mime": "image/png"
        },
        "label": "Asset Label",
        "template_type": "Christmas",
        "medium": "Email",
        "branch": null,
        "type": "brand_asset"
      },
      "post_link": "http://test.com",
      "failed_at": null,
      "failure": null,
      "media_container_id": "test",
      "type": "social_post",
      "created_at": 1765163644.071891,
      "updated_at": 1765163644.071891,
      "deleted_at": null,
      "due_at": 1765163044.043,
      "executed_at": 1765163642.98539,
      "owner": {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "current_time": "9:14 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      }
    },
    {
      "id": "9d6edc23-5772-4130-aa69-8485d32a0bbd",
      "brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
      "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "caption": "this post should be failed in job",
      "facebook_page": "3e49af4c-f0f9-49b5-8124-ba34fe91ef25",
      "template_instance": {
        "id": "ae17e50a-c3ba-4783-8313-c0e8bc43c905",
        "created_at": 1765163642.98539,
        "html": "<div>fakeTemplateInstance</div>",
        "file": {
          "id": "3584c5be-c71b-40c2-9988-38a17ca0ed65",
          "created_at": 1765163643.896974,
          "updated_at": 1765163643.896974,
          "deleted_at": null,
          "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "path": "templates/instances/f3272070-d3e3-11f0-a2d4-1bcac3894d4e.png",
          "name": "image.png",
          "public": true,
          "type": "file",
          "url": "https://test.cloudfront.net/templates/instances/f3272070-d3e3-11f0-a2d4-1bcac3894d4e.png",
          "preview_url": "https://test.cloudfront.net/templates/instances/f3272070-d3e3-11f0-a2d4-1bcac3894d4e.png",
          "mime": "image/png"
        },
        "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "branch": "http://mock-branch-url",
        "updated_at": 1765163642.98539,
        "deleted_at": null,
        "type": "template_instance"
      },
      "asset": null,
      "post_link": null,
      "failed_at": "2025-12-08T03:14:02.985Z",
      "failure": "Internal Server Error",
      "media_container_id": "test",
      "type": "social_post",
      "created_at": 1765163644.124594,
      "updated_at": 1765163644.124595,
      "deleted_at": null,
      "due_at": 1765163044.086,
      "executed_at": 1765163642.98539,
      "owner": {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "current_time": "9:14 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      }
    }
  ],
  "info": {
    "count": 3,
    "total": 3
  }
}

Get Social posts stats of brand

Get Social posts stats of brand
GET/brands/:brand/social-posts/stats{?status}

brand (uuid) ID of the brand

user (uuid) ID of the user (optional)

status (‘executed’ | ‘scheduled’ | ‘draft’ | ‘any’) string (optional)

Example URI

GET /brands/:brand/social-posts/stats?status=executed
URI Parameters
HideShow
brand
string (required) Example: d62bfd9f-b8c2-4be6-864e-1d756b5dbac8
status
string (required) Example: executed
Response  200
HideShow
Body
{
  "type": "social_post_stats",
  "Email": "1",
  "Social": "2"
}

Create a social post with templateInstance

Create a social post with templateInstance
POST/brands/:brand/social-posts

Example URI

POST /brands/:brand/social-posts
URI Parameters
HideShow
brand
string (required) Example: d62bfd9f-b8c2-4be6-864e-1d756b5dbac8
associations
string (required) Example: social_post.template_instance,social_post.owner
Request
HideShow
Body
{
  "facebook_page": "3e63b0a0-b8d4-4f6f-b322-b97a4e40ad45",
  "template_instance": "ae17e50a-c3ba-4783-8313-c0e8bc43c905",
  "due_at": 1765163043.95,
  "caption": "test"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "8455ffab-f4e8-44e5-a888-bb95fa928cfe",
    "brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
    "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "caption": "test",
    "facebook_page": "3e63b0a0-b8d4-4f6f-b322-b97a4e40ad45",
    "template_instance": {
      "id": "ae17e50a-c3ba-4783-8313-c0e8bc43c905",
      "created_at": 1765163642.98539,
      "html": "<div>fakeTemplateInstance</div>",
      "file": {
        "id": "3584c5be-c71b-40c2-9988-38a17ca0ed65",
        "created_at": 1765163643.896974,
        "updated_at": 1765163643.896974,
        "deleted_at": null,
        "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "path": "templates/instances/f3272070-d3e3-11f0-a2d4-1bcac3894d4e.png",
        "name": "image.png",
        "public": true,
        "type": "file",
        "url": "https://test.cloudfront.net/templates/instances/f3272070-d3e3-11f0-a2d4-1bcac3894d4e.png",
        "preview_url": "https://test.cloudfront.net/templates/instances/f3272070-d3e3-11f0-a2d4-1bcac3894d4e.png",
        "mime": "image/png"
      },
      "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "branch": "http://mock-branch-url",
      "updated_at": 1765163642.98539,
      "deleted_at": null,
      "type": "template_instance"
    },
    "post_link": null,
    "failed_at": null,
    "failure": null,
    "media_container_id": null,
    "type": "social_post",
    "created_at": 1765163643.979725,
    "updated_at": 1765163643.979725,
    "deleted_at": null,
    "due_at": 1765163043.95,
    "executed_at": null,
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "Unit",
      "last_name": "Test",
      "email": "[email protected]",
      "phone_number": "+4368120265807",
      "created_at": 1493115498.770362,
      "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1493115498.770744,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": true,
      "timezone": "America/Chicago",
      "user_type": "Admin",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": false,
      "personal_room": null,
      "brand": null,
      "fake_email": false,
      "features": [
        "Deals"
      ],
      "last_seen_at": null,
      "email_signature": null,
      "daily_enabled": false,
      "email_quota": 30000,
      "website": null,
      "instagram": null,
      "twitter": null,
      "linkedin": null,
      "youtube": null,
      "facebook": null,
      "designation": null,
      "tiktok": null,
      "mfa_enabled": false,
      "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "current_time": "9:14 PM - Sunday Dec 07, 2025",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
      "display_name": "Unit Test",
      "abbreviated_display_name": "Unit",
      "online_state": "Offline",
      "has_password": true
    }
  }
}

Create a social post with asset

Create a social post with asset
POST/brands/:brand/social-posts

Example URI

POST /brands/:brand/social-posts
URI Parameters
HideShow
brand
string (required) Example: d62bfd9f-b8c2-4be6-864e-1d756b5dbac8
Request
HideShow
Body
{
  "facebook_page": "3e63b0a0-b8d4-4f6f-b322-b97a4e40ad45",
  "asset": "5d0385d2-0b11-4797-a8bc-cbecf8832db3",
  "due_at": 1765163044.043,
  "caption": "testAsset"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "ca0cf1b0-9700-4392-b22c-c4ce1601ccb1",
    "brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
    "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "caption": "testAsset",
    "facebook_page": "3e63b0a0-b8d4-4f6f-b322-b97a4e40ad45",
    "post_link": null,
    "failed_at": null,
    "failure": null,
    "media_container_id": null,
    "type": "social_post",
    "created_at": 1765163644.071891,
    "updated_at": 1765163644.071891,
    "deleted_at": null,
    "due_at": 1765163044.043,
    "executed_at": null
  }
}

Update social post

Update social post
PUT/brands/:brand/social-posts/:socialPostId

Example URI

PUT /brands/:brand/social-posts/:socialPostId
URI Parameters
HideShow
brand
string (required) Example: d62bfd9f-b8c2-4be6-864e-1d756b5dbac8
socialPostId
string (required) Example: 1252ec89-b723-4a81-9769-52b12e319261
Request
HideShow
Body
{
  "due_at": 1765164244.137,
  "template_instance": "ae17e50a-c3ba-4783-8313-c0e8bc43c905",
  "facebook_page": "3e49af4c-f0f9-49b5-8124-ba34fe91ef25",
  "asset": null,
  "caption": "test"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "1252ec89-b723-4a81-9769-52b12e319261",
    "brand": "d62bfd9f-b8c2-4be6-864e-1d756b5dbac8",
    "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "caption": "test",
    "facebook_page": "3e49af4c-f0f9-49b5-8124-ba34fe91ef25",
    "post_link": null,
    "failed_at": null,
    "failure": null,
    "media_container_id": null,
    "type": "social_post",
    "created_at": 1765163644.035828,
    "updated_at": 1765163642.98539,
    "deleted_at": null,
    "due_at": 1765164244.137,
    "executed_at": null
  }
}

Delete a social post

Delete a social post
DELETE/brands/:brand/social-posts/:socialPostId

Example URI

DELETE /brands/:brand/social-posts/:socialPostId
URI Parameters
HideShow
brand
string (required) Example: d62bfd9f-b8c2-4be6-864e-1d756b5dbac8
socialPostId
string (required) Example: 1e252824-f3d2-4cdc-9639-ce2beee25514
Response  204

Generated by aglio on 08 Dec 2025