---
title: "Get Customer Buyer Persona"
method: GET
path: "/copilot/v1/customer-buyer-personas/{buyerPersonaId}"
tags: ["Customer Buyer Persona"]
---

# Get Customer Buyer Persona

`GET /copilot/v1/customer-buyer-personas/{buyerPersonaId}`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/copilot/v1/customer-buyer-personas/{buyerPersonaId}`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:gtm-config:read`

Retrieves a single Customer Buyer Persona by its unique identifier.

A Buyer Persona represents a profile of a decision-maker or stakeholder that the customer's sales and marketing teams target.
Each persona captures insights into who the ideal buyers are, what motivates them, and how to effectively engage them during the sales process.
If the specified buyerPersonaId does not exist, the endpoint returns **404 Not Found**.

If you do not know the ID of the record you need, call
[List Customer Buyer Personas](ref:customerbuyerpersonainterface_listcustomerbuyerpersonas) to browse the full set.

This endpoint is typically used to retrieve the full configuration of a specific persona before updating or referencing it in downstream workflows.

Common use cases
- Retrieve detailed information about a specific persona
- Load persona data before updating the record
- Use persona context in integrations or automation workflows

## Path parameters

- `buyerPersonaId` string, uuid, required

## Response `200`

Success

- CustomerBuyerPersonaModel: API model for a single customer buyer persona.
  - `data` CustomerBuyerPersona, required: Customer Buyer Persona resource.
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` CustomerBuyerPersonaAttributes, required: Attributes that define a customer buyer persona — a profile representing a type of buyer that the customer's sales team targets. Buyer personas capture who the ideal buyers are, what motivates them, and how to engage them effectively.
      - `name` string: Name of the buyer persona. Required when creating a new record. When provided (for create or update), must be between 1 and 1024 characters.
      - `description` string: Detailed description of this buyer persona, including their role, responsibilities, and relevance to the sales process. Maximum 10,000 characters.
      - `personalObjectives` string: Personal objectives for this persona such as career goals, KPIs, and success metrics that drive their purchasing decisions. Maximum 10,000 characters.
      - `whatDoesThisPersonaCareAbout` string: Messaging angle explaining what this persona cares about in the customer's offering. Maximum 10,000 characters.
      - `titlesFunctionsSeniority` string: Typical job titles, functional areas, and seniority levels associated with this persona. Maximum 10,000 characters.
      - `relevantOfferings` string: Relevant offerings from the customer's portfolio that this persona would be interested in. Maximum 10,000 characters.
      - `source` 'manual' | 'import' | 'system' | 'mcp': Source type indicating how a GTM configuration record was created or last modified. Used across all customer-level entities for audit provenance tracking. When source is explicitly set in a request, the corresponding created_by/updated_by must also be provided. Defaults to 'manual' when not specified.
      - `customFields` CustomFieldItem[]: Flexible key-value store for customer-specific custom fields and extended metadata. The backend validates schema and value types. Use this to capture additional persona attributes beyond the standard fields.
        - `title` string, required: The display title of the custom field.
        - `description` string: An optional description of the field. Defaults to an empty string in the backend.
        - `value` string, required: The string value associated with this custom field.
    - `meta` GtmConfigAuditFields: Common audit fields present on all customer-level GTM configuration entities. These fields track the full lifecycle of a record including creation, modification, archival (temporary hiding), and soft deletion (permanent hiding for compliance). A record can be active, deleted only, or both.
      - `createdAt` string, date-time: ISO 8601 timestamp when the record was originally created. Auto-populated by backend.
      - `updatedAt` string, date-time: ISO 8601 timestamp of the most recent modification to the record. Auto-populated by backend.
      - `createdBy` string: User ID of the person who created the record. Extracted from the JWT token on creation.
      - `updatedBy` string: User ID of the person who last modified the record. Extracted from the JWT token on update.
      - `archivedAt` string, date-time: ISO 8601 timestamp when the record was archived. Archived records are identified by archivedAt and archivedBy
      - `archivedBy` string: User ID of the person who archived the record

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

---

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