---
title: "Assign placement to group"
method: PATCH
path: "/api/profiles/{id}/assign_placement_to_group"
tags: ["Profiles"]
---

# Assign placement to group

`PATCH /api/profiles/{id}/assign_placement_to_group`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/profiles/{id}/assign_placement_to_group`
- Auth: HTTP bearer

Moves a single placement (a Facebook Page, LinkedIn organization, Telegram channel, Google Business location, etc.) into a different profile group, independent of where its parent connection is homed. A placement belongs to exactly one group at a time.

## Path parameters

- `id` string, required

## Query parameters

- `profile_group_id` string

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `placement_id` string, required: Platform-specific placement ID, as returned by List placements.
  - `target_profile_group_id` string, required: ID of the profile group to move the placement into. Must be in the same environment (live/sandbox) as your API key.

## Response `200`

The moved placement, plus its new group

- object: A placement a profile can publish to (Facebook Page, LinkedIn organization or personal profile, Pinterest board, Telegram channel, Google Business location).
  - `id` string, nullable: Platform-specific placement ID. null for personal profile (LinkedIn).
  - `name` string: Display name of the placement.
  - `avatar_url` string, nullable: Stable Postproxy storage URL of the placement's picture, resized to 256x256 (Facebook Pages). null until it has been mirrored and for networks without one.
  - `metadata` object: Extra per-placement data Postproxy stores. For Google Business this carries the location's place_id (Google Maps Place ID). {} when there's nothing extra.
  - `profile_group_id` string: ID of the profile group the placement now belongs to.

## Other responses

- `400`: Missing required parameters.
- `401`: Invalid, missing, or insufficient API key permissions.
- `404`: Resource does not exist or is not accessible.

---

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