Перейти до основного контенту

Grinfi.io API Documentation - Велике оновлення

Автор: Alexandr Mishyn
Оновлено протягом останнього тижня

Дата: Квітень 2026
API Reference: api.grinfi.io

Ми повністю переробили публічну API документацію. Нова версія покриває 124 ендпоінти у 6 категоріях - кожен протестований на продакшені.

Що нового

🔗 Webhooks (6 ендпоінтів)

Тепер можна повністю керувати вебхуками через API:

  • Створення, оновлення, видалення та список вебхуків

  • Тестова відправка перед запуском

  • Підтримувані події: contact_replied_email, contact_replied_linkedin_message, contact_exported, contact_enriched

👤 Акаунт і Команди (3 ендпоінти)

  • Отримання профілю поточного користувача

  • Список ваших команд

  • Деталі команди

🌐 LinkedIn Browsers (7 ендпоінтів)

Повний контроль над браузерними профілями LinkedIn:

  • Список, створення, оновлення та видалення браузерів

  • Запуск і зупинка сесій

  • Зміна проксі-налаштувань

  • Шерінг доступу з членами команди

📁 Папки автоматизацій (3 ендпоінти)

Організація автоматизацій у папки:

  • Список, створення та оновлення папок (workspaces)

📥 Джерела даних (5 ендпоінтів)

Управління LinkedIn імпортами:

  • Список, створення, оновлення та видалення джерел даних

  • Підтримувані типи: CSV, Sales Navigator, LinkedIn пошук та інші

  • Відстеження статусу: not_started, in_progress, completed, failed

📊 Метрики автоматизацій (1 ендпоінт)

Отримання метрик по одній або кількох автоматизаціях за один запит - кількість лідів, в процесі, завершених, з помилками та розбивка по задачах.

⚡ Масові дії з контактами (1 ендпоінт)

Групові операції з контактами:

  • Додати/видалити/замінити теги

  • Змінити список або стадію пайплайну

  • Оновити кастомні поля

  • Додати до автоматизації або зупинити

  • Видалити або експортувати контакти

Що покращено

✅ Точні схеми відповідей

Всі схеми перевірені проти реальних відповідей API:

  • Schedule - виправлено на min/max (хвилини від півночі), а не from/to

  • Tasks - додано 15+ полів: payload, attempts, error_msg, priority, automation_error_code та інші

  • Sender Profiles - додано smart_limits_enabled, avatar_url, schedule, hold_tasks_till

  • LinkedIn Messages - додано linkedin_type, fail_reason, read_at, sent_at

  • Automations - додано use_sender_schedule

  • Error responses - тепер відповідають реальному формату з reason, message, data

📋 Повні переліки значень (enums)

Кожен enum тепер містить всі можливі значення:

  • Статуси контактів, LinkedIn статуси, email статуси

  • Типи та статуси задач (включно з skipped)

  • Типи активностей (12+ типів задокументовано)

  • Статуси автоматизацій

  • Типи та статуси джерел даних

📝 Кращі описи

  • Ліміт запитів задокументовано: 300 запитів/хвилину

  • Пояснено пріоритет дедуплікації контактів

  • Роз'яснено роботу з кастомними полями (використовуйте upsert або custom-field-values, а не PUT /leads)

  • Система фільтрів з усіма операторами: >=, <=, >, <, =, !=, is_null, is_not_null

  • Фільтр активностей: формат JSON-рядка, а не окремі query-параметри

Видалено (неробочі)

Прибрано ендпоінти, які існували в документації, але не працюють на платформі Grinfi:

  • File Import/Export (використовуйте UI для CSV імпорту)

  • Flow Versions (внутрішня функція)

  • Деякі операції LinkedIn Browsers (proxy countries, check-proxy)

Quick Start

Quick Start гайд оновлено:

  • Секція Webhooks в огляді API

  • Приклад перевірки статусу LinkedIn з'єднання

  • Робота з кастомними полями: два підходи (окремо або через upsert)

Структура API

Категорія

Що включає

Account

Current user, Teams

CRM

Contacts, Companies, Lists, Tags, Pipeline, Custom Fields, Notes, Activities, Data Sources

Outreach

Automations, Automation Folders, Tasks, Sender Profiles

Messaging

LinkedIn Messages, Emails, Mailboxes

Browsers

LinkedIn Browser profiles

Integrations

Webhooks

Повна документація: api.grinfi.io

Ви отримали відповідь на своє запитання?