> ## Documentation Index > Fetch the complete documentation index at: https://docs.adspo.co/llms.txt > Use this file to discover all available pages before exploring further. # Add brand to group > Adds a brand to one of your groups, like adding it to a group in the app. If the brand isn't followed in the group's workspace yet, it's followed too. Only brands already in Adspo can be added: find them with [Search brands](/api-reference/search-brands). The follow is yours: the key's owner, or through the MCP, the person who connected it. Adding a brand that's already in the group returns `200` with `already_in_group: true` and is free, as are requests that fail. Adding a new one returns `201` and costs 1 credit, including following it if needed. It counts towards the follow limit of 30 a minute per person. > [!NOTE] > > **Credits:** 1 credit when it adds the brand to the group, including following it if needed. Free when it's already in the group, or when the request fails. ## OpenAPI ````yaml POST /v1/groups/{group_id}/brands openapi: 3.1.0 info: title: Adspo API version: 1.0.0 description: > The Adspo API gives you programmatic access to ad creative data across brands. ## Authentication All endpoints require an API key passed in the `x-api-key` header. ``` x-api-key: YOUR_API_KEY ``` ## Rate limits - **120 requests per minute** per key. Exceeding this returns `429` with a `Retry-After` header. Every response carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` headers. - **Credits per billing period** vary by plan. Each request costs 1 credit (`/v1/usage` is free). Exceeding your quota returns `429` with `resets_at` indicating when it resets. - A key whose account has no active subscription gets `403`. - **Changes** have their own per-person limits, across all their keys and connections: saving creatives and adding them to boards, 30 a minute; creating boards, 10 a minute; following brands and adding them to groups, 30 a minute. Exceeding these returns `429` with a `Retry-After` header. Each costs 1 credit only when it changes something; anything already there is free. servers: - url: https://api.adspo.co description: Production security: - apiKey: [] paths: /v1/groups/{group_id}/brands: post: summary: Add brand to group description: > Adds a brand to one of your groups, like adding it to a group in the app. If the brand isn't followed in the group's workspace yet, it's followed too. Only brands already in Adspo can be added: find them with [Search brands](/api-reference/search-brands). The follow is yours: the key's owner, or through the MCP, the person who connected it. Adding a brand that's already in the group returns `200` with `already_in_group: true` and is free, as are requests that fail. Adding a new one returns `201` and costs 1 credit, including following it if needed. It counts towards the follow limit of 30 a minute per person. operationId: addGroupBrand parameters: - name: group_id in: path required: true description: The group's ID, from [Get groups](/api-reference/get-groups). schema: type: string format: uuid example: 5b9f3c2e-8d41-4e6a-9a57-2f1c0d7e8b44 requestBody: required: true content: application/json: schema: type: object required: - brand_id properties: brand_id: type: string description: >- The brand's Facebook Ad Library page ID, from [Search brands](/api-reference/search-brands). example: brand_id: '15087023444' responses: '200': description: Already in the group. Nothing changed, and no credit was used. content: application/json: schema: $ref: '#/components/schemas/GroupBrandResult' '201': description: Added to the group (and followed, if it wasn't) just now. content: application/json: schema: $ref: '#/components/schemas/GroupBrandResult' example: group_id: 5b9f3c2e-8d41-4e6a-9a57-2f1c0d7e8b44 brand_id: '15087023444' brand_name: Nike workspace_id: null already_followed: true already_in_group: false '400': description: No `brand_id`. content: application/json: schema: $ref: '#/components/schemas/Error' '401': $ref: '#/components/responses/ChangeUnauthorized' '403': $ref: '#/components/responses/ChangeForbidden' '404': description: >- The group isn't one of yours, or the brand isn't in Adspo (find brands with [Search brands](/api-reference/search-brands)). content: application/json: schema: $ref: '#/components/schemas/Error' '429': $ref: '#/components/responses/FollowTooManyRequests' '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: GroupBrandResult: type: object properties: group_id: type: string format: uuid brand_id: type: string description: Facebook Ad Library page ID. brand_name: type: string workspace_id: type: string format: uuid nullable: true description: The group's workspace. null for the default workspace. already_followed: type: boolean description: >- Whether the brand was already followed in the group's workspace, by you or your team. already_in_group: type: boolean description: Whether the brand was already in the group. Error: type: object properties: error: type: string responses: ChangeUnauthorized: description: Missing or invalid API key, or an MCP connection that has been revoked. content: application/json: schema: $ref: '#/components/schemas/Error' ChangeForbidden: description: >- No active subscription, or the person behind an MCP connection is no longer in the team. content: application/json: schema: $ref: '#/components/schemas/Error' FollowTooManyRequests: description: > Too many follows (more than 30 a minute per person, counting both following and adding to groups), or one of the usual rate or credit limits. The `Retry-After` header gives the seconds to wait. headers: Retry-After: description: Seconds until you can follow again. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: error: 'Follow limit reached: at most 30 follows per minute.' securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: Your Adspo API key. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.