---
title: "Star a contact"
method: PUT
path: "/service_agents/contacts/{id}/star"
tags: ["Service Agent"]
---

# Star a contact

`PUT /service_agents/contacts/{id}/star`

## Request

- Base URL: `https://api.voipbin.net/v1.0`
- URL: `https://api.voipbin.net/v1.0/service_agents/contacts/{id}/star`
- Auth: none declared
- TypeScript: <https://skmtc.dev/voipbin/apis/voipbin-api/docs/service_agents/contacts/:id/star/put.ts> (a function with typed inputs; its response is checked against the schema)

Star the contact for the calling agent. A star is private to the agent: other agents never
see it. The call is idempotent: starring a contact that is already starred returns the
existing star with its original `tm_create`. A contact that does not exist, is deleted, or
belongs to another customer returns 404.

## Path parameters

- `id` string, uuid, required

## Response `200`

The contact is starred.

- ContactManagerContactStar
  - `contact_id` string, uuid, required: The contact ID returned from GET /service_agents/contacts.
  - `starred` boolean, required: Whether the calling agent has starred the contact.
  - `tm_create` string, date-time: When the contact was starred. Absent when starred is false.

## Other responses

- `400`: Invalid request (INVALID_ARGUMENT).
- `401`: Authentication required (UNAUTHENTICATED).
- `403`: Insufficient permission (PERMISSION_DENIED).
- `404`: Resource not found (NOT_FOUND).
- `500`: Internal error (INTERNAL).

## Changes

- **2026-11-02** `77a8b1190027`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/service_agents/contacts/:id/star/put.md)

---

[API](https://skmtc.dev/voipbin/apis/voipbin-api.md) - [All operations](https://skmtc.dev/voipbin/apis/voipbin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voipbin/apis/voipbin-api/revisions/ae049dcc6c89?raw)