SendGrid PHP Library

The Marketing Campaigns API allows you to perform the following operations:

• Retrieve all Campaigns: Get a list of all campaigns (newest first) using get() with optional limit and offset query parameters.
• Retrieve a single campaign: Get details for a specific campaign using its campaign_id.
• Update a Campaign: Modify existing campaign parameters (like subject, title, or html_content) using patch().
• Delete a Campaign: Remove a specific campaign using delete().
• Schedule a Campaign: Set a specific date and time for a campaign to be sent using post() on the schedules() endpoint.
• Update a Scheduled Campaign: Change the scheduled time and date for an existing campaign using patch() on the schedules() endpoint.

// Example: Retrieve all campaigns
$query_params = json_decode('{"limit": 1, "offset": 1}');
$response = $sg->client->campaigns()->get(null, $query_params);

// Example: Update a campaign
$campaign_id = "test_url_param";
$request_body = json_decode('{
  "subject": "New Products for Summer!"
}');
$response = $sg->client->campaigns()->_($campaign_id)->patch($request_body);

// Example: Schedule a campaign
$campaign_id = "test_url_param";
$request_body = json_decode('{
  "send_at": 1489771528
}');
$response = $sg->client->campaigns()->_($campaign_id)->schedules()->post($request_body);

IP Pools allow you to group dedicated Twilio SendGrid IP addresses together (e.g., separating transactional and marketing traffic) to maintain separate reputations. Each user can create up to 10 different IP pools. Note that IP pools can only be used with authenticated IP addresses.

Create an IP pool

Use POST /ips/pools with a JSON body containing the name.

Retrieve all IP pools

Use GET /ips/pools to list all existing pools.

Update an IP pool name

Use PUT /ips/pools/{pool_name} with a JSON body containing the new name.

Delete an IP pool

Use DELETE /ips/pools/{pool_name}.

// Create an IP pool
$request_body = json_decode('{
  "name": "marketing"
}');
$response = $sg->client->ips()->pools()->post($request_body);

// Retrieve all IP pools
$response = $sg->client->ips()->pools()->get();

// Update an IP pool name
$request_body = json_decode('{
  "name": "new_pool_name"
}');
$pool_name = "test_url_param";
$response = $sg->client->ips()->pools()->_($pool_name)->put($request_body);

// Delete an IP pool
$pool_name = "test_url_param";
$response = $sg->client->ips()->pools()->_($pool_name)->delete();