PHP

composer require onlyform/onlyform-php

use Onlyform\Client;

$onlyform = new Client(
    apiKey: $_ENV['ONLYFORM_API_KEY'],
);

$created = $onlyform->forms()->create(
    name: 'Product feedback',
    workspaceId: '507f1f77bcf86cd799439012',
    type: 'MULTI',
    definition: [
        'blocks' => [[
            'id' => 'rating',
            'type' => 'rating',
            'label' => 'How would you rate the product?',
            'description' => '',
            'required' => true,
            'properties' => ['max' => 5, 'icon' => 'star'],
        ]],
        'settings' => ['progressBar' => true],
        'theme' => [
            'font' => 'Inter',
            'colors' => ['primary' => '#3969D9'],
        ],
        'variables' => ['score' => 0, 'price' => 0, 'segment' => 'new-customer'],
        'hidden_fields' => ['campaign_id', 'account_id'],
    ],
);

echo $created['id'];

$current = $onlyform->forms()->retrieve('form_id');

$added = $onlyform->forms()->blocks()->create(
    formId: 'form_id',
    block: [
        'id' => 'email',
        'type' => 'email',
        'label' => 'Email address',
        'description' => 'Where should we reply?',
        'required' => true,
        'properties' => [],
    ],
    ifMatch: $current->etag,
);

$onlyform->forms()->blocks()->delete(
    formId: 'form_id',
    blockId: 'email',
    ifMatch: $added->etag,
);

$current = $onlyform->forms()->retrieve('form_id');

$updated = $onlyform->forms()->update(
    formId: 'form_id',
    changes: [
        'name' => 'Customer feedback',
        'definition' => [
            'settings' => ['progressBar' => false],
            'theme' => ['font' => 'Georgia', 'colors' => ['primary' => '#3969D9']],
        ],
    ],
    ifMatch: $current->etag,
);

$cursor = null;

do {
    $page = $onlyform->forms()->list(limit: 100, cursor: $cursor);

    foreach ($page['items'] as $form) {
        echo $form['id'] . PHP_EOL;
    }

    $cursor = $page['page']['next_cursor'];
} while ($cursor !== null);

$workspaces = $onlyform->workspaces()->list(limit: 50);
$submissions = $onlyform->forms()->submissions()->list('form_id', limit: 100);
$metrics = $onlyform->forms()->analytics()->metrics('form_id', period: '30d');
$webhooks = $onlyform->webhooks()->list();

use Onlyform\Exception\ApiException;
use Onlyform\Exception\TransportException;

try {
    $onlyform->forms()->retrieve('form_id');
} catch (ApiException $error) {
    error_log(sprintf(
        '%d %s request=%s',
        $error->status,
        $error->errorCode,
        $error->requestId ?? 'unknown',
    ));
} catch (TransportException $error) {
    error_log($error->getMessage());
}