use ZabbixApi;

my $api = ZabbixApi->new(
    user => 'winston',
    pw   => 'gayhaim69',
    url  => 'http://my.domain.com/api_jsonrpc.php',
);

# set api method
$zabbix->set_method('hostgroup.get');

# wrapper around output: set to 'extend'
$zabbix->payload->set_output(3);

# perform api call
$zabbix->process;

# find the Object describing Linux servers group
my $o = $zabbix->find_by( 'name', 'Linux servers' );

# we got a hash
my $id = $$o{'groupid'};

# clear the api buffer before the next action

$zabbix->clear;

# set api method
$zabbix->set_method('host.create');

# add the new hostgroup
$zabbix->add_params( { groups => [ { 'groupid' => $id } ] } );

# add the interfaces
$zabbix->add_params(
    {
        interfaces =>
        [
            {
                 'useip' => 1,
                 'ip'    => '188.187.123.123',
                 'port'  => '10050',
                 'dns'   => 'test.com',
                 'type'  => 1,
                 'main'  => 1,
            }
        ]
    }
);

# add the new hostname
$zabbix->add_params( { 'host' => 'testhost' } );

# perform the api call which creates the hostgroup
$zabbix->process;