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

# Public Endpoint - Custom Markers

This endpoint is an alternative to our [markers api endpoint](/api/markers#custom-marker) endpoint,
and uses a different authentication method.

## Endpoint

Request method: `POST`

| Endpoint                                                                         | Description                 |
| -------------------------------------------------------------------------------- | --------------------------- |
| [https://appsignal-endpoint.net/markers](https://appsignal-endpoint.net/markers) | Accepts JSON formatted data |

## URL parameters

Depending on the API key you'd like to use, you can either:

### Push API key

| Parameter   | Type   | Description                                                                                      |
| ----------- | ------ | ------------------------------------------------------------------------------------------------ |
| api\_key    | String | **Push** API key, can be found in [App settings](https://appsignal.com/redirect-to/app?to=info). |
| name        | String | The application name.                                                                            |
| environment | String | The environment that the application is running in.                                              |

```shell Shell theme={null}
https://appsignal-endpoint.net/markers?api_key=<api_key>&name=<name>&environment=<environment>
```

### Front-end API key

| Parameter | Type   | Description                                                                                           |
| --------- | ------ | ----------------------------------------------------------------------------------------------------- |
| api\_key  | String | **Front-end** API key, can be found in [App settings](https://appsignal.com/redirect-to/app?to=info). |

```shell Shell theme={null}
https://appsignal-endpoint.net/markers?api_key=<api_key>
```

## Body parameters

The post body should contain a JSON object, formatted as follows:

| Parameter   | Type                                                      | Description                                                                         |
| ----------- | --------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| created\_at | Date - [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) | Time at which to insert the marker. Leave empty to use the current time.            |
| icon        | String - Optional                                         | Emoji to use for this Custom marker, defaults to 🚀.                                |
| message     | String - Optional                                         | Message shown when hovering over the marker in the UI. Truncated to 200 characters. |

For example:

<CodeGroup>
  ```json JSON theme={null}
  {
    "created_at": "2015-07-21T15:06:31.737+02:00",
    "icon": "🚀",
    "message": "Upscaled the database for better performance"
  }
  ```
</CodeGroup>