create.post

Метод доступен с помощью ключа доступа access_token

Данный метод позволяет создать запланированный пост в разделе Отложенные посты.

Обязательные параметры:

Параметр

Описание

id_group (integer) Обязательный параметр

Идентификатор сообщества или страницы текущего пользователя ВКонтакте, на стене которого должна быть опубликована запись.

name (string) Обязательный параметр

Название сообщества для отображения в запланированных постах

name_autopost (string) Необязательный параметр

Название поста для отображения в запланированных постах

primary_attachments_mode (checkbox) Необязательный параметр

Вид вложений 0 - сетка 1 - карусель По умолчанию сетка.

photo (string) Обязательный параметр

Аватар для отображения в запланированных постах

date_post (string) Обязательный параметр

Дата публикации поста Пример: 2025-02-21 15:40

post_day (string) Обязательный параметр

Режим публикаций

oneraz - на один раз

everyday - каждый день

budday - будние дни (кроме сб. и вс.)

weekends - выходные дни (сб. и вс.)

every2day - раз в 2 дня

every3day - раз в 3 дня

every4day - раз в 4 дня

every5day - раз в 5 дней

every6day - раз в 6 дней

everyweek - каждую неделю

every8day - раз в 8 дней

every9day - раз в 9 дней

every10day - раз в 10 дней

every11day - раз в 11 дней

every12day - раз в 12 дней

every13day - раз в 13 дней

every2week - каждые 2 недели

every3week - каждые 3 недели

everymonth - каждый месяц

every2month - каждые 2 месяца

every3month - каждые 3 месяца

every4month - каждые 4 месяца

every5month - каждые 5 месяцев

every6month - каждые 6 месяцев

every7month - каждые 7 месяцев

every8month - каждые 8 месяцев

every9month - каждые 9 месяцев

every10month - каждые 10 месяцев

every11month - каждые 11 месяцев

every12month - каждый год

message (text) Необязательный параметр

Текст записи (является обязательным, если не задан параметр attachments).

attachments (string) Обязательный параметр если не указан message

Объект или несколько объектов, приложенных к записи. К записи можно приложить медиа или ссылку на внешнюю страницу. Если объектов несколько, их нужно указать через запятую «,».

Формат описания медиа-приложения:

<type><owner_id>_<media_id>

<type> — тип медиа-приложения:

  • photo — фотография;

  • video — видеозапись;

  • audio — аудиозапись;

  • doc — документ;

  • page — wiki-страница;

  • note — заметка;

  • poll — опрос;

  • album — альбом;

  • market — товар;

  • market_album — подборка товаров;

  • audio_playlist — плейлист с аудио.

<owner_id> — идентификатор владельца медиа-приложения (обратите внимание, если объект находится в сообществе, значение должно быть отрицательным числом).

<media_id> — идентификатор медиа-приложения.

Формат описания ссылки:

<protocol><URL>

<protocol> — протокол HTTP или HTTPS.

<URL> — оставшаяся часть URL.

Формат для перечисления объектов:

<type><owner_id>_<media_id>,<type><owner_id>_<media_id>,<protocol<URL>

Обратите внимание, можно указать несколько медиа-приложений, но только одну ссылку. Если указать больше одной ссылки, будет возвращена ошибка.

Примеры:

photo100172_166443618,photo-1_265827614

photo66748_265827614,https://example.ru

https://example.ru

Параметр attachments является обязательным, если не задано значение message.

repost_object (string) Необязательный параметр

Ссылка на репост

Пример:

https://vk.com/wall66748_3675

repost_comment (string) Необязательный параметр

Комментарий к репосту

delete_post_date (string) Необязательный параметр

Удаление задания в конкретную дату (удаления поста из запланированных постов Впостера).

Пример:

2025-02-28

stop_post_date (string) Необязательный параметр

Приостановление задания в конкретную дату (приостановка поста из запланированных постов Впостера).

Пример:

2025-02-28

signed (checkbox) Не обязательный параметр

1 — у записи будет добавлена подпись (имя пользователя, разместившего запись), 0 — подписи добавлено не будет. По умолчанию подпись не добавляется.

mute_notifications (checkbox) Не обязательный параметр

1 — уведомления к записям будут отключены, 0 — уведомления к записям будут включены. По умолчанию уведомления включены.

mark_as_ads (checkbox) Не обязательный параметр

1 — у записи будет добавлена метка Реклама от автора, 0 — метки добавлено не будет.

close_comments (checkbox) Не обязательный параметр

1 — комментарии к записи отключены, 0 — комментарии к записи включены. По умолчанию комментарии включены.

wall_pin (checkbox) Не обязательный параметр

1 — закреплять пост на стене, 0 — не закреплять пост. По умолчанию пост не закрепляется.

wall_unpin_date (string) Не обязательный параметр

Укажите дату и время, если нужно авто-открепление поста. Пример:

2025-02-28 15:40

del_task (checkbox) Не обязательный параметр

1 — удалить пост после публикации из запланированных постов Впостера, 0 — не удалять. По умолчанию 0 - пост не удаляется.

donut_type (integer) Не обязательный параметр

Видимость поста только для донов. В настройках сообщества должен быть включен VK Donut! 0 - неограниченно 1 - на 1 день 2 - на 2 дня 3 - на 3 дня 4 - на 4 дня 5 - на 5 дней 6- на 6 дней 7- на 7 дней

delete_clock (int) Не обязательный параметр

Автоматическое удаление поста из VK (часы) От 1 до 23 Максимум 23 часа Данный параметр настраивается совместно с параметром delete_minutes

delete_minutes (int) Не обязательный параметр

Автоматическое удаление поста из VK (минуты) От 1 до 59 Максимум 59 минут Данный параметр настраивается совместно с параметром delete_clock

Пример

Пример кода на языке PHP для обращения к методам API.

$params = [
    "id_group" => 79668981,
    "name" => "Впостер",
    "name_autopost" => "Тестовый пост через API",
    "photo" => "https://pp.userapi.com/s/v1/if1/uKaQngH4dcpFIX6PH7v9trw8IDPU6BLczgtHkvOHccT5dElpnLkfDwuwIA4ZKN7rW9l1ohbR.jpg?quality=96&crop=0,0,1080,1080&as=32x32,48x48,72x72,108x108,160x160,240x240,360x360,480x480,540x540,640x640,720x720,1080x1080&ava=1&cs=100x100",
    "date_post" => "2025-02-21 15:40",
    "post_day" => "oneraz",
    "message" => "Здесь текст вашего поста",
    "attachments" => "photo-79668981_457269772,photo-79668981_457269771",
    "access_token" => "507f7e85b8d7a88c83c8df09b217882e18b5d885a1ff8c88"
];

$myCurl = curl_init();
curl_setopt_array($myCurl, [
    CURLOPT_URL => "https://vposter.ru/api/v2/method/create.post",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($params)
]);

$res= curl_exec($myCurl);
curl_close($myCurl);

$request = json_decode($res, true);

if(isset($request['response'])) {
  // Успешно
} else {
  if(isset($request['error']['error_msg'])) {
     // Ошибка
   }
}

Last updated