LEleadfeeder
Buyer Personas
v1

Update a Buyer Persona

Changed on

Update an existing buyer persona. All attributes are optional; only the attributes you send are changed. Sending filters replaces every category, not just the one you name.

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

patch/v1/buyer-personas/{id}

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/buyer-personas/{id}
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: buyer_personas:write

Path parameters

idstring required

The buyer persona ID.

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": {
    "attributes": {
      "filters": {
        "department": [
          {
            "display_value": "Sales",
            "search_value": "sales_department"
          }
        ],
        "job_title": [
          {
            "display_value": "revenue operations",
            "search_value": "revenue operations"
          }
        ],
        "location": [
          {
            "display_value": "Germany",
            "search_value": "DE",
            "type": "country_code"
          }
        ],
        "seniority": [
          {
            "display_value": "Top management",
            "search_value": "top_management"
          }
        ]
      },
      "name": "Sales Leaders"
    },
    "type": "buyer_persona"
  }
}

Response

Success

Example response

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

Changes

  • ac752c6c2be0Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 885dcce2a6c2Revision changes
    • breaking

      removed the enum value unknown_department of the request property /////