---
title: "Add social handle to brand"
method: PUT
path: "/api/company/{id}/social-handles"
tags: ["Brand"]
---

# Add social handle to brand

`PUT /api/company/{id}/social-handles`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/company/{id}/social-handles`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/company/:id/social-handles/put.ts> (a function with typed inputs; its response is checked against the schema)

Assigns an unmatched social handle to a brand and triggers a rescan

## Path parameters

- `id` integer, required

## Request body

- object
  - `handle` string, required: Social media handle
  - `type` string, required: Social platform type (twitter, facebook, instagram, tiktok)

## Response `200`

Social handle added successfully

- CompanyResource: Brand details with related data (agencies, organizations, primary/secondary profiles)
  - `created_by_agent` string, nullable: Name of the agent that created the brand. Null when a person created it.

## Other responses

- `401`: Unauthenticated
- `422`: Validation error
- `500`: Failed to add social handle

---

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