Ads and Commerce
Ads and Commerce
Resources

Customize Stories

Updated: May 3, 2024
If you transform a non 9:16 ad creative into a full-screen story format, you can also edit the generated background colors.
You can edit the background color for the top and bottom above and below your ad creative by using a hex color code. You can choose separate colors for the top and bottom.
This feature works for all stories placements across Instagram, Facebook, and Messenger. It is also available for static single image ads, video ads, and ads using placement asset customization.

Get Started

To use this API, make a POST request to portrait_customizations under AD_ACCOUNT_ID/adcreatives:
portrait_customizations: {
    specifications: [
        {
            background_color: {
                bottom_color: "0D3F0C", // RGB HEX string
                top_color: "CC8400", // RGB HEX string
                },
        },
    ],
}
To read your color settings, make a GET request to AD_CREATIVE_ID?fields=portrait_customizations.
The response looks like this:
{
  "portrait_customizations": {
    "specifications": [
      {
        "background_color": {
          "top_color": "0D3F0C",
          "bottom_color": "CC8400"
        }
      }
    ]
  },
  "id": "AD_CREATIVE_ID"
}

Limitations

Resources

Did you find this page helpful?
Thumbs up icon
Thumbs down icon