> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Niftyimages

> Allowing marketers to create dynamic and personalized content for your email campaigns.

![Niftyimages logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/niftyimages.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=42b00a720d1afefb94cf160df533f58a)

* **Category:** marketing automation
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 9
* **Triggers:** 0
* **Slug:** `NIFTYIMAGES`
* **Version:** 20260615\_00

## Tools

> [accordion] Get Images Stats
>
> **Slug:** `NIFTYIMAGES_GET_IMAGES_STATS`
>
> Tool to get aggregated stats for all images. Use when you need to retrieve statistical data and performance metrics for all images in the account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Widget User Images
>
> **Slug:** `NIFTYIMAGES_GET_WIDGET_USER_IMAGES`
>
> Tool to list widget images for a specific user. Use when you need to retrieve all images associated with a particular user and widget combination.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> The user identifier to retrieve images for.
>
> **widget\_key** `string` *required*
>
> The unique identifier (key) of the widget. This is a UUID format identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Widget User Stats
>
> **Slug:** `NIFTYIMAGES_GET_WIDGET_USER_STATS`
>
> Tool to get aggregated stats for a specific user on a widget. Use when you need to retrieve performance metrics for a particular user's interaction with a widget.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> The user identifier for which to retrieve aggregated stats
>
> **widget\_key** `string` *required*
>
> The unique identifier (key) of the widget
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Images
>
> **Slug:** `NIFTYIMAGES_LIST_IMAGES`
>
> Tool to page through images in your NiftyImages account. Use when you need to retrieve a list of all available images.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (1-based). Defaults to the first page when not specified.
>
> **page\_size** `integer`
>
> Number of images to return per page. Defaults to the API default when not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Maps
>
> **Slug:** `NIFTYIMAGES_LIST_MAPS`
>
> Tool to retrieve all maps in your NiftyImages account. Use when you need to view all available maps for geo-targeting or location-based email content.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Widget Images
>
> **Slug:** `NIFTYIMAGES_LIST_WIDGET_IMAGES`
>
> Tool to list widget images for a time frame. Use when you need to retrieve images generated by a specific widget within an optional date range.
>
> #### Input Parameters
>
> **end\_date** `string`
>
> End date in ISO 8601 format (e.g., 2024-12-31T23:59:59Z). Filter images created on or before this date.
>
> **start\_date** `string`
>
> Start date in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Filter images created on or after this date.
>
> **widget\_key** `string` *required*
>
> The unique identifier (key) of the widget. This is a UUID format identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Widgets
>
> **Slug:** `NIFTYIMAGES_LIST_WIDGETS`
>
> Tool to list all widgets in your NiftyImages account. Use when you need to retrieve all available widgets.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List widget stats
>
> **Slug:** `NIFTYIMAGES_LIST_WIDGET_STATS`
>
> Tool to retrieve widget statistics for a specified time frame from NiftyImages. Use when you need to view performance metrics such as impressions and clicks for your widgets.
>
> #### Input Parameters
>
> **endDate** `string`
>
> End date for the stats time frame in ISO 8601 format (e.g., 2016-03-10T08:00Z). If not provided, stats up to the current time will be included.
>
> **startDate** `string`
>
> Start date for the stats time frame in ISO 8601 format (e.g., 2016-02-10T08:00Z). If not provided, stats from the beginning will be included.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Widget Users
>
> **Slug:** `NIFTYIMAGES_LIST_WIDGET_USERS`
>
> Tool to list widget users for a specified time frame from NiftyImages. Use when you need to retrieve users who interacted with a specific widget during a date range.
>
> #### Input Parameters
>
> **endDate** `string`
>
> End date for the time frame in ISO 8601 format (e.g., 2026-02-13T23:59:59Z). If not specified, defaults to API's default end date.
>
> **startDate** `string`
>
> Start date for the time frame in ISO 8601 format (e.g., 2026-01-01T00:00:00Z). If not specified, defaults to API's default start date.
>
> **widgetKey** `string` *required*
>
> The unique identifier (key) of the widget to retrieve users for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
