Sign in
Buyer Personas
v1

Create a Buyer Persona

Create a new buyer persona in the account.

Credit Note: Creating a buyer persona does not consume credits.

:::info Requires the buyer_personas:write OAuth2 scope. :::

post/v1/buyer-personas

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Request body

Example request

{
  "data": {
    "type": "buyer_persona",
    "attributes": {
      "name": "Sales Leaders",
      "filters": {
        "department": [
          {
            "search_value": "sales_department",
            "display_value": "Sales"
          }
        ],
        "seniority": [
          {
            "search_value": "top_management",
            "display_value": "Top management"
          }
        ],
        "job_title": [
          {
            "search_value": "revenue operations",
            "display_value": "revenue operations"
          }
        ],
        "location": [
          {
            "search_value": "DE",
            "type": "country_code",
            "display_value": "Germany"
          }
        ]
      }
    }
  }
}

Response

Success

Example response

{
  "data": {
    "type": "buyer_persona",
    "id": "7421",
    "attributes": {
      "name": "Sales Managers",
      "created_at": "2024-12-10T15:57:25Z",
      "filters": {
        "department": [
          {
            "search_value": "US",
            "display_value": "United States"
          }
        ],
        "job_title": [
          {
            "search_value": "US",
            "display_value": "United States"
          }
        ],
        "location": [
          {
            "search_value": "US",
            "display_value": "United States"
          }
        ],
        "seniority": [
          {
            "search_value": "US",
            "display_value": "United States"
          }
        ]
      }
    }
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}