Koveh API

Job Application Sender API

Automate sending job applications via Telegram and Email

Job Application Sender API

This API allows you to automate sending job applications via Telegram and Email. It is designed to be integrated with automation tools like Tubeform or custom scripts.

Authentication

All API requests must include the X-API-Key header with your secret key.

X-API-Key: your_secret_key

Endpoints

Send CV

POST /send-cv

Sends a CV and a personalized message to a recruiter or contact person.

Request Body

FieldTypeRequiredDescription
modestringYesSending mode: "tg" (Telegram) or "email" (Email).
targetstringYesThe recipient. Telegram username (e.g., "daniilvpn") or Email address (e.g., "hr@company.com").
job_linkstringYesThe URL of the job posting (used in the message).
contact_namestringNoName of the contact person. If provided, the message will be personalized (e.g., "Ivan, good afternoon!").

Example Request

{
  "mode": "tg",
  "target": "daniilvpn",
  "job_link": "https://t.me/pydevjob/2309",
  "contact_name": "Ivan"
}

Responses

  • 200 OK: Message sent successfully.
  • 403 Forbidden: Invalid or missing API Key.
  • 500 Internal Server Error: Failed to send message (check logs for details).

Features

Smart Greetings

The API automatically adjusts the greeting based on the current time of day (Moscow Time):

  • 03:00 - 09:00: "Доброе утро"
  • 09:00 - 17:00: "Добрый день"
  • 17:00 - 03:00: "Добрый вечер"

Integration with Tubeform

This API accepts standard JSON payloads, making it compatible with any form builder or automation platform that supports Webhooks or REST API calls. Ensure your webhook sends the correct JSON structure and headers.

On this page