Klaviyo · Capability

Klaviyo API — Profiles

Klaviyo API — Profiles. 36 operations. Lead operation: Get Bulk Import Profiles Jobs. Self-contained Naftiko capability covering one Klaviyo business surface.

Run with Naftiko KlaviyoProfiles

What You Can Do

GET
Getbulkimportprofilesjobs — Get Bulk Import Profiles Jobs
/v1/api/profile-bulk-import-jobs
POST
Bulkimportprofiles — Bulk Import Profiles
/v1/api/profile-bulk-import-jobs
GET
Geterrorsforbulkimportprofilesjob — Get Errors for Bulk Import Profiles Job
/v1/api/profile-bulk-import-jobs/{id}/import-errors
GET
Getlistforbulkimportprofilesjob — Get List for Bulk Import Profiles Job
/v1/api/profile-bulk-import-jobs/{id}/lists
GET
Getprofilesforbulkimportprofilesjob — Get Profiles for Bulk Import Profiles Job
/v1/api/profile-bulk-import-jobs/{id}/profiles
GET
Getlistidsforbulkimportprofilesjob — Get List IDs for Bulk Import Profiles Job
/v1/api/profile-bulk-import-jobs/{id}/relationships/lists
GET
Getprofileidsforbulkimportprofilesjob — Get Profile IDs for Bulk Import Profiles Job
/v1/api/profile-bulk-import-jobs/{id}/relationships/profiles
GET
Getbulkimportprofilesjob — Get Bulk Import Profiles Job
/v1/api/profile-bulk-import-jobs/{job-id}
POST
Createorupdateprofile — Create or Update Profile
/v1/api/profile-import
POST
Mergeprofiles — Merge Profiles
/v1/api/profile-merge
POST
Bulksubscribeprofiles — Bulk Subscribe Profiles
/v1/api/profile-subscription-bulk-create-jobs
POST
Bulkunsubscribeprofiles — Bulk Unsubscribe Profiles
/v1/api/profile-subscription-bulk-delete-jobs
GET
Getbulksuppressprofilesjobs — Get Bulk Suppress Profiles Jobs
/v1/api/profile-suppression-bulk-create-jobs
POST
Bulksuppressprofiles — Bulk Suppress Profiles
/v1/api/profile-suppression-bulk-create-jobs
GET
Getbulksuppressprofilesjob — Get Bulk Suppress Profiles Job
/v1/api/profile-suppression-bulk-create-jobs/{job-id}
GET
Getbulkunsuppressprofilesjobs — Get Bulk Unsuppress Profiles Jobs
/v1/api/profile-suppression-bulk-delete-jobs
POST
Bulkunsuppressprofiles — Bulk Unsuppress Profiles
/v1/api/profile-suppression-bulk-delete-jobs
GET
Getbulkunsuppressprofilesjob — Get Bulk Unsuppress Profiles Job
/v1/api/profile-suppression-bulk-delete-jobs/{job-id}
GET
Getprofiles — Get Profiles
/v1/api/profiles
POST
Createprofile — Create Profile
/v1/api/profiles
GET
Getprofile — Get Profile
/v1/api/profiles/{id}
PATCH
Updateprofile — Update Profile
/v1/api/profiles/{id}
GET
Getconversationforprofile — Get Conversation for Profile
/v1/api/profiles/{id}/conversation
GET
Getlistsforprofile — Get Lists for Profile
/v1/api/profiles/{id}/lists
GET
Getpushtokensforprofile — Get Push Tokens for Profile
/v1/api/profiles/{id}/push-tokens
GET
Getconversationidforprofile — Get Conversation ID for Profile
/v1/api/profiles/{id}/relationships/conversation
GET
Getlistidsforprofile — Get List IDs for Profile
/v1/api/profiles/{id}/relationships/lists
GET
Getpushtokenidsforprofile — Get Push Token IDs for Profile
/v1/api/profiles/{id}/relationships/push-tokens
GET
Getsegmentidsforprofile — Get Segment IDs for Profile
/v1/api/profiles/{id}/relationships/segments
GET
Getsegmentsforprofile — Get Segments for Profile
/v1/api/profiles/{id}/segments
GET
Getpushtokens — Get Push Tokens
/v1/api/push-tokens
POST
Createpushtoken — Create or Update Push Token
/v1/api/push-tokens
GET
Getpushtoken — Get Push Token
/v1/api/push-tokens/{id}
DELETE
Deletepushtoken — Delete Push Token
/v1/api/push-tokens/{id}
GET
Getprofileforpushtoken — Get Profile for Push Token
/v1/api/push-tokens/{id}/profile
GET
Getprofileidforpushtoken — Get Profile ID for Push Token
/v1/api/push-tokens/{id}/relationships/profile

MCP Tools

get-bulk-import-profiles-jobs

Get Bulk Import Profiles Jobs

read-only idempotent
bulk-import-profiles

Bulk Import Profiles

get-errors-bulk-import-profiles

Get Errors for Bulk Import Profiles Job

read-only idempotent
get-list-bulk-import-profiles

Get List for Bulk Import Profiles Job

read-only idempotent
get-profiles-bulk-import-profiles

Get Profiles for Bulk Import Profiles Job

read-only idempotent
get-list-ids-bulk-import

Get List IDs for Bulk Import Profiles Job

read-only idempotent
get-profile-ids-bulk-import

Get Profile IDs for Bulk Import Profiles Job

read-only idempotent
get-bulk-import-profiles-job

Get Bulk Import Profiles Job

read-only idempotent
create-update-profile

Create or Update Profile

merge-profiles

Merge Profiles

bulk-subscribe-profiles

Bulk Subscribe Profiles

bulk-unsubscribe-profiles

Bulk Unsubscribe Profiles

get-bulk-suppress-profiles-jobs

Get Bulk Suppress Profiles Jobs

read-only idempotent
bulk-suppress-profiles

Bulk Suppress Profiles

get-bulk-suppress-profiles-job

Get Bulk Suppress Profiles Job

read-only idempotent
get-bulk-unsuppress-profiles-jobs

Get Bulk Unsuppress Profiles Jobs

read-only idempotent
bulk-unsuppress-profiles

Bulk Unsuppress Profiles

get-bulk-unsuppress-profiles-job

Get Bulk Unsuppress Profiles Job

read-only idempotent
get-profiles

Get Profiles

read-only idempotent
create-profile

Create Profile

get-profile

Get Profile

read-only idempotent
update-profile

Update Profile

idempotent
get-conversation-profile

Get Conversation for Profile

read-only idempotent
get-lists-profile

Get Lists for Profile

read-only idempotent
get-push-tokens-profile

Get Push Tokens for Profile

read-only idempotent
get-conversation-id-profile

Get Conversation ID for Profile

read-only idempotent
get-list-ids-profile

Get List IDs for Profile

read-only idempotent
get-push-token-ids-profile

Get Push Token IDs for Profile

read-only idempotent
get-segment-ids-profile

Get Segment IDs for Profile

read-only idempotent
get-segments-profile

Get Segments for Profile

read-only idempotent
get-push-tokens

Get Push Tokens

read-only idempotent
create-update-push-token

Create or Update Push Token

get-push-token

Get Push Token

read-only idempotent
delete-push-token

Delete Push Token

idempotent
get-profile-push-token

Get Profile for Push Token

read-only idempotent
get-profile-id-push-token

Get Profile ID for Push Token

read-only idempotent

Capability Spec

klaviyo-profiles.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: Klaviyo API — Profiles
  description: 'Klaviyo API — Profiles. 36 operations. Lead operation: Get Bulk Import Profiles Jobs. Self-contained Naftiko
    capability covering one Klaviyo business surface.'
  tags:
  - Klaviyo
  - Profiles
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    KLAVIYO_API_KEY: KLAVIYO_API_KEY
capability:
  consumes:
  - type: http
    namespace: klaviyo-profiles
    baseUri: https://a.klaviyo.com
    description: Klaviyo API — Profiles business capability. Self-contained, no shared references.
    resources:
    - name: api-profile-bulk-import-jobs
      path: /api/profile-bulk-import-jobs
      operations:
      - name: getbulkimportprofilesjobs
        method: GET
        description: Get Bulk Import Profiles Jobs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields[profile-bulk-import-job]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: filter
          in: query
          type: string
          description: 'For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed
            field(s)/operator(s):<br>`status`: `'
        - name: page[cursor]
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        - name: page[size]
          in: query
          type: integer
          description: 'Default: 20. Min: 1. Max: 100.'
        - name: sort
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
      - name: bulkimportprofiles
        method: POST
        description: Bulk Import Profiles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-profile-bulk-import-jobs-id-import-errors
      path: /api/profile-bulk-import-jobs/{id}/import-errors
      operations:
      - name: geterrorsforbulkimportprofilesjob
        method: GET
        description: Get Errors for Bulk Import Profiles Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: fields[import-error]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: page[cursor]
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        - name: page[size]
          in: query
          type: integer
          description: 'Default: 20. Min: 1. Max: 100.'
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profile-bulk-import-jobs-id-lists
      path: /api/profile-bulk-import-jobs/{id}/lists
      operations:
      - name: getlistforbulkimportprofilesjob
        method: GET
        description: Get List for Bulk Import Profiles Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: fields[list]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profile-bulk-import-jobs-id-profiles
      path: /api/profile-bulk-import-jobs/{id}/profiles
      operations:
      - name: getprofilesforbulkimportprofilesjob
        method: GET
        description: Get Profiles for Bulk Import Profiles Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: additional-fields[profile]
          in: query
          type: array
          description: 'Request additional fields not included by default in the response. Supported values: ''subscriptions'',
            ''predictive_analytics'''
        - name: fields[profile]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: page[cursor]
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        - name: page[size]
          in: query
          type: integer
          description: 'Default: 20. Min: 1. Max: 100.'
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profile-bulk-import-jobs-id-relationships-lists
      path: /api/profile-bulk-import-jobs/{id}/relationships/lists
      operations:
      - name: getlistidsforbulkimportprofilesjob
        method: GET
        description: Get List IDs for Bulk Import Profiles Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profile-bulk-import-jobs-id-relationships-profiles
      path: /api/profile-bulk-import-jobs/{id}/relationships/profiles
      operations:
      - name: getprofileidsforbulkimportprofilesjob
        method: GET
        description: Get Profile IDs for Bulk Import Profiles Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: page[cursor]
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        - name: page[size]
          in: query
          type: integer
          description: 'Default: 20. Min: 1. Max: 100.'
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profile-bulk-import-jobs-job_id
      path: /api/profile-bulk-import-jobs/{job_id}
      operations:
      - name: getbulkimportprofilesjob
        method: GET
        description: Get Bulk Import Profiles Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: job_id
          in: path
          type: string
          description: ID of the job to retrieve.
          required: true
        - name: fields[list]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: fields[profile-bulk-import-job]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: include
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profile-import
      path: /api/profile-import
      operations:
      - name: createorupdateprofile
        method: POST
        description: Create or Update Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: additional-fields[profile]
          in: query
          type: array
          description: 'Request additional fields not included by default in the response. Supported values: ''subscriptions'',
            ''predictive_analytics'''
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-profile-merge
      path: /api/profile-merge
      operations:
      - name: mergeprofiles
        method: POST
        description: Merge Profiles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-profile-subscription-bulk-create-jobs
      path: /api/profile-subscription-bulk-create-jobs
      operations:
      - name: bulksubscribeprofiles
        method: POST
        description: Bulk Subscribe Profiles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-profile-subscription-bulk-delete-jobs
      path: /api/profile-subscription-bulk-delete-jobs
      operations:
      - name: bulkunsubscribeprofiles
        method: POST
        description: Bulk Unsubscribe Profiles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-profile-suppression-bulk-create-jobs
      path: /api/profile-suppression-bulk-create-jobs
      operations:
      - name: getbulksuppressprofilesjobs
        method: GET
        description: Get Bulk Suppress Profiles Jobs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields[profile-suppression-bulk-create-job]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: filter
          in: query
          type: string
          description: 'For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed
            field(s)/operator(s):<br>`status`: `'
        - name: page[cursor]
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        - name: sort
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
      - name: bulksuppressprofiles
        method: POST
        description: Bulk Suppress Profiles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-profile-suppression-bulk-create-jobs-job_id
      path: /api/profile-suppression-bulk-create-jobs/{job_id}
      operations:
      - name: getbulksuppressprofilesjob
        method: GET
        description: Get Bulk Suppress Profiles Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: job_id
          in: path
          type: string
          description: ID of the job to retrieve.
          required: true
        - name: fields[profile-suppression-bulk-create-job]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profile-suppression-bulk-delete-jobs
      path: /api/profile-suppression-bulk-delete-jobs
      operations:
      - name: getbulkunsuppressprofilesjobs
        method: GET
        description: Get Bulk Unsuppress Profiles Jobs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields[profile-suppression-bulk-delete-job]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: filter
          in: query
          type: string
          description: 'For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed
            field(s)/operator(s):<br>`status`: `'
        - name: page[cursor]
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        - name: sort
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
      - name: bulkunsuppressprofiles
        method: POST
        description: Bulk Unsuppress Profiles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-profile-suppression-bulk-delete-jobs-job_id
      path: /api/profile-suppression-bulk-delete-jobs/{job_id}
      operations:
      - name: getbulkunsuppressprofilesjob
        method: GET
        description: Get Bulk Unsuppress Profiles Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: job_id
          in: path
          type: string
          description: ID of the job to retrieve.
          required: true
        - name: fields[profile-suppression-bulk-delete-job]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profiles
      path: /api/profiles
      operations:
      - name: getprofiles
        method: GET
        description: Get Profiles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: additional-fields[profile]
          in: query
          type: array
          description: 'Request additional fields not included by default in the response. Supported values: ''subscriptions'',
            ''predictive_analytics'''
        - name: fields[profile]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: fields[push-token]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: filter
          in: query
          type: string
          description: 'For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed
            field(s)/operator(s):<br>`id`: `any`'
        - name: include
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
        - name: page[cursor]
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        - name: page[size]
          in: query
          type: integer
          description: 'Default: 20. Min: 1. Max: 100.'
        - name: sort
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
      - name: createprofile
        method: POST
        description: Create Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: additional-fields[profile]
          in: query
          type: array
          description: 'Request additional fields not included by default in the response. Supported values: ''subscriptions'',
            ''predictive_analytics'''
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-profiles-id
      path: /api/profiles/{id}
      operations:
      - name: getprofile
        method: GET
        description: Get Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: additional-fields[profile]
          in: query
          type: array
          description: 'Request additional fields not included by default in the response. Supported values: ''subscriptions'',
            ''predictive_analytics'''
        - name: fields[list]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: fields[profile]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: fields[push-token]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: fields[segment]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: include
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
      - name: updateprofile
        method: PATCH
        description: Update Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Primary key that uniquely identifies this profile. Generated by Klaviyo.
          required: true
        - name: additional-fields[profile]
          in: query
          type: array
          description: 'Request additional fields not included by default in the response. Supported values: ''subscriptions'',
            ''predictive_analytics'''
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-profiles-id-conversation
      path: /api/profiles/{id}/conversation
      operations:
      - name: getconversationforprofile
        method: GET
        description: Get Conversation for Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profiles-id-lists
      path: /api/profiles/{id}/lists
      operations:
      - name: getlistsforprofile
        method: GET
        description: Get Lists for Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: fields[list]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profiles-id-push-tokens
      path: /api/profiles/{id}/push-tokens
      operations:
      - name: getpushtokensforprofile
        method: GET
        description: Get Push Tokens for Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: fields[push-token]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profiles-id-relationships-conversation
      path: /api/profiles/{id}/relationships/conversation
      operations:
      - name: getconversationidforprofile
        method: GET
        description: Get Conversation ID for Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profiles-id-relationships-lists
      path: /api/profiles/{id}/relationships/lists
      operations:
      - name: getlistidsforprofile
        method: GET
        description: Get List IDs for Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profiles-id-relationships-push-tokens
      path: /api/profiles/{id}/relationships/push-tokens
      operations:
      - name: getpushtokenidsforprofile
        method: GET
        description: Get Push Token IDs for Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profiles-id-relationships-segments
      path: /api/profiles/{id}/relationships/segments
      operations:
      - name: getsegmentidsforprofile
        method: GET
        description: Get Segment IDs for Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-profiles-id-segments
      path: /api/profiles/{id}/segments
      operations:
      - name: getsegmentsforprofile
        method: GET
        description: Get Segments for Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: fields[segment]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
    - name: api-push-tokens
      path: /api/push-tokens
      operations:
      - name: getpushtokens
        method: GET
        description: Get Push Tokens
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields[profile]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: fields[push-token]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: filter
          in: query
          type: string
          description: 'For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed
            field(s)/operator(s):<br>`id`: `equa'
        - name: include
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
        - name: page[cursor]
          in: query
          type: string
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        - name: page[size]
          in: query
          type: integer
          description: 'Default: 20. Min: 1. Max: 100.'
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
      - name: createpushtoken
        method: POST
        description: Create or Update Push Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: revision
          in: header
          type: string
          description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-push-tokens-id
      path: /api/push-tokens/{id}
      operations:
      - name: getpushtoken
        method: GET
        description: Get Push Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The value of the push token
          required: true
        - name: fields[profile]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: fields[push-token]
          in: query
          type: array
          description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        - name: i

# --- truncated at 32 KB (69 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/capabilities/klaviyo-profiles.yaml