# Announcement Categories

## Category object

Announcement Categories have the following fields

| Field                                          | Details                                                      |
| ---------------------------------------------- | ------------------------------------------------------------ |
| <p><strong>id</strong><br>integer</p>          | Category ID                                                  |
| <p><strong>idx</strong><br>string</p>          | Encoded category ID                                          |
| <p><strong>name</strong><br>string</p>         | Category name                                                |
| <p><strong>color</strong><br>string</p>        | Hex RGB color code                                           |
| <p><strong>company\_id</strong><br>integer</p> | Company ID                                                   |
| <p><strong>created\_at</strong><br>string</p>  | The date & time the category was created (UTC timezone)      |
| <p><strong>updated\_at</strong><br>string</p>  | The date & time the category was last updated (UTC timezone) |
| <p><strong>translations</strong><br>object</p> | Localized category names                                     |

### Endpoints

You can use the following endpoints to manage Announcement Categories

{% openapi src="<https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media>" path="/api/v1/announcement-categories" method="get" %}
[announcement\_categories.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media)
{% endopenapi %}

{% openapi src="<https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media>" path="/api/v1/announcement-categories" method="post" %}
[announcement\_categories.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media)
{% endopenapi %}

{% openapi src="<https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media>" path="/api/v1/announcement-categories/{categoryIdx}" method="get" %}
[announcement\_categories.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media)
{% endopenapi %}

{% openapi src="<https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media>" path="/api/v1/announcement-categories/{categoryIdx}" method="post" %}
[announcement\_categories.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media)
{% endopenapi %}

{% openapi src="<https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media>" path="/api/v1/announcement-categories/{categoryIdx}" method="delete" %}
[announcement\_categories.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-ac6754dc07fd008e7b27ac5867e2a6715dcce17c%2Fannouncement_categories.yaml?alt=media)
{% endopenapi %}

## Related

* [Announcements](https://developers.frill.co/api/reference/announcements) - Learn how to manage announcements that use these categories