> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CustomerTag

> A named customer tag in this store's Redo catalog. Shopify-originated tags are stored here after sync; this API never queries Shopify.

**Required scopes:** [`customers_read`](/docs/api-reference/v3/reference/scopes#scope-customers_read), [`customers_write`](/docs/api-reference/v3/reference/scopes#scope-customers_write)

<ResponseField name="id" type="ID!" required>
  The id of this customer tag.
</ResponseField>

<ResponseField name="legacyId" type="String!" required>
  The tag's legacy Mongo ObjectId (24-char hex) from before the CockroachDB migration.
</ResponseField>

<ResponseField name="name" type="String!" required>
  The merchant-facing name of the tag.
</ResponseField>

<ResponseField name="provider" type={<a href="/docs/api-reference/v3/reference/marketing/customer-tag-provider">CustomerTagProvider</a>}>
  Who has authority to add or remove this tag. Null on older records that predate provider.
</ResponseField>

<ResponseField name="source" type={<a href="/docs/api-reference/v3/reference/marketing/customer-tag-source">CustomerTagSource!</a>} required>
  Where this tag was created.
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.