Loops

Loops Contact properties API

Create and list the custom properties available on contacts. 2 operation(s) in the Loops REST API v1 (OpenAPI 1.21.6).

Documentation GitHub OpenAPI

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/contacts/properties Create a custom contact property · Create a contact property #

Ask an LLM

“How do I add a new custom field to my contacts?”

“What naming style should a new contact property use?”

Tell an agent

Create a contact property {name} of type {type}.

Add a custom {type} field called {name} to contacts.

GET /v1/contacts/properties List contact properties · List contact properties #

Ask an LLM

“What contact properties does my account have?”

“Can I see only the custom contact properties?”

Tell an agent

List all my contact properties.

List contact properties filtered to {list}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/loops:loops-contact-properties-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Loops OpenAPI Spec Contact properties API
  description: This is the OpenAPI Spec for the Loops API.
  version: 1.21.6
servers:
- url: https://app.loops.so/api
tags:
- name: Contact properties
  description: Manage contact properties
paths:
  /v1/contacts/properties:
    post:
      operationId: createContactProperty
      tags:
      - Contact properties
      summary: Create a contact property
      description: Create a custom contact property.
      x-mint:
        href: /api-reference/create-contact-property
        metadata:
          sidebarTitle: Create property
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContactPropertyCreateRequest'
        required: true
      responses:
        '200':
          description: Successful create.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactPropertySuccessResponse'
        '400':
          description: Bad request (e.g. invalid type).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactPropertyFailureResponse'
        '405':
          description: Wrong HTTP request method.
      security:
      - apiKey: []
    get:
      operationId: listContactProperties
      tags:
      - Contact properties
      summary: List contact properties
      description: 'Retrieve a list of your account''s contact properties.

        Use the `list` parameter to query "all" or "custom" properties.'
      x-mint:
        href: /api-reference/list-contact-properties
        metadata:
          sidebarTitle: List properties
          description: Retrieve a list of your account's contact properties.
      parameters:
      - name: list
        in: query
        required: false
        description: '`all` (default) or `custom` (only custom contact properties)'
        schema:
          type: string
      responses:
        '200':
          description: Successful.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ContactProperty'
        '405':
          description: Wrong HTTP request method.
      security:
      - apiKey: []
components:
  schemas:
    ContactPropertyFailureResponse:
      type: object
      properties:
        success:
          type: boolean
          examples:
          - false
        message:
          type: string
          examples:
          - Property already exists.
      required:
      - success
      - message
      examples:
      - success: false
        message: Property already exists.
    ContactProperty:
      type: object
      properties:
        key:
          type: string
          description: The key of the contact property.
        label:
          type: string
          description: The human-friendly label for this property.
        type:
          type: string
          description: The type of property.
          enum:
          - string
          - number
          - boolean
          - date
      examples:
      - key: favoriteColor
        label: Favorite color
        type: string
      required:
      - key
      - label
      - type
    ContactPropertyCreateRequest:
      type: object
      required:
      - name
      - type
      description: There are a few [reserved names](https://loops.so/docs/contacts/properties#reserved-names) that you cannot use for contact properties.
      properties:
        name:
          type: string
          examples:
          - favoriteColor
          description: The name of the property. This should be in camelCase, like `planName` or `importDate`.
        type:
          type: string
          examples:
          - string
          description: The type of property.
          enum:
          - string
          - number
          - boolean
          - date
      examples:
      - name: favoriteColor
        type: string
    ContactPropertySuccessResponse:
      type: object
      properties:
        success:
          type: boolean
          examples:
          - true
      required:
      - success
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer