---
title: AnalyticsAnnotationCreatePayload - GraphQL Admin
description: Return type for `analyticsAnnotationCreate` mutation.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/AnalyticsAnnotationCreatePayload
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/AnalyticsAnnotationCreatePayload.md
api_name: admin
api_type: graphql
type: payload
---

# Analytics​Annotation​Create​Payload

payload

Return type for `analyticsAnnotationCreate` mutation.

## Fields

* analytics​Annotation

  [Analytics​Annotation](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotation)

  The newly created analytics annotation.

* user​Errors

  [\[Analytics​Annotation​Create​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotationCreateUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [analytics​Annotation​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationCreate)

  mutation

  Creates an [analytics annotation](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotation) on the shop. Annotations are notable events that can be overlaid on analytics charts to provide context for changes in metrics. The annotation is attributed to the app that calls the mutation.

  Shopify limits how many annotations an app can have for a shop. If the app reaches this limit, then the mutation returns a `LIMIT_REACHED` error. Delete existing annotations or contact Shopify Support to request a higher limit.

  Use [`analyticsAnnotationUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationUpdate) to modify existing annotations or [`analyticsAnnotationDelete`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationDelete) to remove them.

  The `type` field must specify a supported type for app-created annotations. Refer to the list of [supported types](https://shopify.dev/docs/api/shopifyql/latest/syntax/annotate#annotation-categories-and-types).

  * input

    [Analytics​Annotation​Create​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/AnalyticsAnnotationCreateInput)

    required

    ### Arguments

    The input fields for creating an analytics annotation.

  ***

***

## Map

### Mutations with this payload

* [analytics​Annotation​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationCreate)