Lead Metadata Properties API
Retrieve the list of metadata property keys that exist across all leads in your organization. This endpoint powers dynamic dropdowns in the UI, such as when selecting attributes for profile scoring rules or building lead filters.
GET /lead-metadata-properties
Returns distinct metadata property keys from all lead records in the authenticated organization.
Request
No query parameters required.
Response
200 OK
[
"company",
"job_title",
"industry",
"source",
"utm_campaign"
]
Returns a JSON array of property key strings.
Example
curl -X GET "https://api.leadvibe.com/lead-metadata-properties" \
-H "Authorization: Bearer <token>"
Common Errors
| Status | Meaning | Solution |
|---|---|---|
| 401 | Unauthorized | Check authentication credentials |
| 500 | Server Error | Contact support if the issue persists |
Notes
- Property keys are derived from the
metadatafield on lead records - The list grows automatically as new metadata keys are added to leads via the API or integrations
- Commonly used for populating attribute selectors when creating Profile Scoring Rules
Related Endpoints
- Lead by ID - Get lead details including metadata
- Lead Metadata - Update metadata on a specific lead
- Profile Scoring Rulesets - Configure profile scoring based on metadata attributes