# Tags

Tags are essential data labels that empower you to effortlessly monitor a subscriber's journey, such as whether they have made a purchase, completed an onboarding step, or advanced through a drip campaign. These versatile tags allow you to not only segment but also perform detailed queries on the users they are assigned to. By leveraging tags, you can create highly targeted marketing strategies, personalize user experiences, and gain deeper insights into customer behavior. The ability to dynamically apply and update tags ensures that you maintain an up-to-date and actionable view of your audience. 


## Available Endpoints


| Method                                                      | Endpoint                                                        | Name                                     |
|-------------------------------------------------------------|-----------------------------------------------------------------|------------------------------------------|
|     |  | [Create Tags](/docs/tags_api#create-tag) |
|  |  | [Get Tags](/docs/tags_api#get-tags)      |
|  |  | [Delete Tag](/docs/tags_api#delete-tag) |


## The Tag Model


  
    The tag model is a simple named data point you can use to tag subscribers.
  
  
    ### Properties

    
      - **name** (`string`): 
        The name of the tag
      
    
  


---

## Get Tags {{ tag: 'GET', label: '/v1/fetch/tags' }}


  
    Returns a list of tags in your account.

  
  
    
  

<br/><br/>

  
    ### Response
    Returns a list of Tags in your account.

  
  
    
  


---

## Create Tag {{ tag: 'POST', label: '/v1/fetch/tags' }}


  
    Creates a custom tag in your account.

    
> Only a single tag can be created at a time.


    ### Required Attributes
    
      - **name** (`string`): 
        The name of the tag to create.
      
    

  
  
    
  

<br/><br/>

  
    ### Response
    Returns the details of the created Tag.

  
  
    
  


---

## Delete Tag {{ tag: 'DELETE', label: '/v1/fetch/tags' }}


  
    Discards a tag in your account.

    
> Send the same `tag.name` payload shape as create, but use the `DELETE` method.


    ### Required Attributes
    
      - **name** (`string`): 
        The name of the tag to discard.