# Track

The Track is how you record any actions your users perform, along with any properties that describe the action.\
\
Each action is known as an event. Each event has a name, like **User Registered**, and properties. For example, a **User Registered** event might have properties like `plan` or `accountType`. Calling Track in one of our sources is one of the first steps to getting started with Hoodle.

```
POST https://api.hoodleapp.com/api/event/track
```

This API call requires the following field:

* name: The name of the event

It also accepts two optional fields:

* **data**: A JSON object containing additional event details. These key-value pairs can be used within automations or workflows triggered by this event.
* **contact\_external\_id:** If provided, the event will be associated with the contact matching this identifier

This flexible structure allows you to define and track any type of event and attach relevant metadata to enhance your automation capabilities.

```
track("User Registered", {
  plan: "Pro Annual",
  accountType: "Facebook"
});
```

\
**Properties**

Properties are extra pieces of information you can tie to events you track. They can be anything that will be useful while analyzing the events later or use in flows. Hoodle recommends sending properties whenever possible because they give you a more complete picture of what your users are doing.
