Agile CRM

Agile CRM Contacts API

The Contacts API from Agile CRM — 18 operation(s) for contacts.

GitHub OpenAPI

Operations 20

GET /api/contacts List contacts ordered by creation time #
POST /api/contacts Create a new contact (or company when type is COMPANY) #
POST /api/contacts/add-score Adjust lead score #
POST /api/contacts/add/property Update a single contact property #
POST /api/contacts/change-owner Reassign contact owner #
PUT /api/contacts/delete/tags Remove tags from a contact #
PUT /api/contacts/edit-properties Partially update contact properties #
PUT /api/contacts/edit/add-star Update star rating #
PUT /api/contacts/edit/lead-score Modify lead score #
PUT /api/contacts/edit/tags Add tags to a contact #
POST /api/contacts/email/tags/add Add tags via email #
POST /api/contacts/email/tags/delete Remove tags via email #
POST /api/contacts/search/email Search multiple contacts by email #
GET /api/contacts/search/email/{email} Find a contact by email #
GET /api/contacts/search/phonenumber/{phone} Locate a contact by phone number #
GET /api/contacts/{contact_id}/tasks/sort Get associated tasks for a contact #
GET /api/contacts/{id} Get a contact by ID #
DELETE /api/contacts/{id} Delete a contact #
POST /api/filters/filter/dynamic-filter Filter contacts dynamically #
GET /api/search Search contacts and companies by keyword #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/agile-crm/refs/heads/main/openapi/agile-crm-contacts-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/agile-crm/refs/heads/main/overlays/agile-crm-contacts-overlay.yaml

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/agile-crm-contacts-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

agile-crm-contacts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Agile CRM REST Campaigns Contacts API
  version: 1.0.0
  description: HTTPS-only REST API for managing contacts, companies, deals (opportunities), campaigns, tasks, events, notes, tracks, tickets, and documents in Agile CRM. Authentication is HTTP Basic with account email as username and REST client API key as password.
  contact:
    name: Agile CRM
    url: https://www.agilecrm.com/api
servers:
- url: https://{domain}.agilecrm.com/dev
  description: Tenant-scoped base URL
  variables:
    domain:
      default: mydomain
      description: Your Agile CRM tenant subdomain
security:
- BasicAuth: []
tags:
- name: Contacts
paths:
  /api/contacts:
    get:
      tags:
      - Contacts
      summary: List contacts ordered by creation time
      responses:
        '200':
          description: Contact list
      operationId: listContacts
    post:
      tags:
      - Contacts
      summary: Create a new contact (or company when type is COMPANY)
      responses:
        '200':
          description: Contact created
      operationId: createContact
  /api/contacts/add-score:
    post:
      tags:
      - Contacts
      summary: Adjust lead score
      responses:
        '200':
          description: Score adjusted
      operationId: addLeadScore
  /api/contacts/add/property:
    post:
      tags:
      - Contacts
      summary: Update a single contact property
      responses:
        '200':
          description: Property updated
      operationId: updateContactProperty
  /api/contacts/change-owner:
    post:
      tags:
      - Contacts
      summary: Reassign contact owner
      responses:
        '200':
          description: Owner reassigned
      operationId: changeContactOwner
  /api/contacts/delete/tags:
    put:
      tags:
      - Contacts
      summary: Remove tags from a contact
      responses:
        '200':
          description: Tags removed
      operationId: deleteContactTags
  /api/contacts/edit-properties:
    put:
      tags:
      - Contacts
      summary: Partially update contact properties
      responses:
        '200':
          description: Properties updated
      operationId: updateContactProperties
  /api/contacts/edit/add-star:
    put:
      tags:
      - Contacts
      summary: Update star rating
      responses:
        '200':
          description: Star rating updated
      operationId: updateStarValue
  /api/contacts/edit/lead-score:
    put:
      tags:
      - Contacts
      summary: Modify lead score
      responses:
        '200':
          description: Lead score updated
      operationId: updateLeadScore
  /api/contacts/edit/tags:
    put:
      tags:
      - Contacts
      summary: Add tags to a contact
      responses:
        '200':
          description: Tags added
      operationId: addContactTags
  /api/contacts/email/tags/add:
    post:
      tags:
      - Contacts
      summary: Add tags via email
      responses:
        '200':
          description: Tags added
      operationId: addTagsByEmail
  /api/contacts/email/tags/delete:
    post:
      tags:
      - Contacts
      summary: Remove tags via email
      responses:
        '200':
          description: Tags removed
      operationId: deleteTagsByEmail
  /api/contacts/search/email:
    post:
      tags:
      - Contacts
      summary: Search multiple contacts by email
      responses:
        '200':
          description: Contacts found
      operationId: searchContactsByEmail
  /api/contacts/search/email/{email}:
    get:
      tags:
      - Contacts
      summary: Find a contact by email
      parameters:
      - name: email
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Contact found
      operationId: getContactByEmail
  /api/contacts/search/phonenumber/{phone}:
    get:
      tags:
      - Contacts
      summary: Locate a contact by phone number
      parameters:
      - name: phone
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Contact found
      operationId: getContactByPhone
  /api/contacts/{contact_id}/tasks/sort:
    get:
      tags:
      - Contacts
      summary: Get associated tasks for a contact
      parameters:
      - $ref: '#/components/parameters/ContactId'
      responses:
        '200':
          description: Tasks
      operationId: listContactTasks
  /api/contacts/{id}:
    get:
      tags:
      - Contacts
      summary: Get a contact by ID
      parameters:
      - $ref: '#/components/parameters/Id'
      responses:
        '200':
          description: Contact details
      operationId: getContact
    delete:
      tags:
      - Contacts
      summary: Delete a contact
      parameters:
      - $ref: '#/components/parameters/Id'
      responses:
        '204':
          description: Contact deleted
      operationId: deleteContact
  /api/filters/filter/dynamic-filter:
    post:
      tags:
      - Contacts
      summary: Filter contacts dynamically
      responses:
        '200':
          description: Filtered contacts
      operationId: filterContactsDynamic
  /api/search:
    get:
      tags:
      - Contacts
      summary: Search contacts and companies by keyword
      responses:
        '200':
          description: Search results
      operationId: searchContactsAndCompanies
components:
  parameters:
    Id:
      name: id
      in: path
      required: true
      schema:
        type: string
    ContactId:
      name: contact_id
      in: path
      required: true
      schema:
        type: string
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
      description: HTTP Basic auth - username is account email, password is REST client API key.