REST Email Marketing API Documentation

Segments — CreateFixed

Create a new fixed segment, providing the set of recipients to use.

HTTP VERB

Post

URL

/API/Rest/Segments/CreateFixed

ARGUMENTS

name The name of the new fixed segment
description A description for your own use to help identify the segment
emailAddresses An array of email addresses

Required permission

CreateEditFixedSegment

ERRORS

No Permission
Please provide a name with less than 25 characters
Name is already in use
Invalid name
No recipients provided to create fixed segment
Too many API calls
Database error
Unknown error

RETURNS

A structure with two arrays, duplicates and badRecipients. Everyone who is not listed was added to the segment successfully.


{"duplicates":[],"badRecipients":["abc@aol.com","Joe@hotmail.com","fred@aol.com"]}

EXAMPLE

Create a new fixed segment.

using System;
using System.Net.Http;
using System.Text;

string url = "https://example.com/API/Rest/Segments/CreateFixed";
string message = "{\"accountName\":\"acme\",\"login\":\"ApiUser\",\"password\":\"YOUR_PASSWORD\",\"name\":\"Test1\",\"description\":\"some description\",\"emailAddresses\":[\"joe@example.com\",\"abc@aol.com\",\"sam@hotmail.com\",\"rick@aol.com\",\"doug@yahoo.com\"]}";

// Reuse HttpClient for multiple requests in production code.
using (var client = new HttpClient())
using (var request = new HttpRequestMessage(HttpMethod.Post, url))
{
	request.Content = new StringContent(message, Encoding.UTF8, "application/json");

	using (HttpResponseMessage response = await client.SendAsync(request))
	{
		response.EnsureSuccessStatusCode();
		Console.WriteLine(await response.Content.ReadAsStringAsync());
	}
}
			
# encoding: utf-8
require 'rest-client'
require 'json'
							
url = 'https://example.com/API/Rest/Segments/CreateFixed'
args = {'accountName'=>'acme', 'login'=>'ApiUser', 'password'=>'YOUR_PASSWORD', 'name'=>'Test1','description'=>'some description','emailAddresses'=>['joe@example.com', 'abc@aol.com', 'sam@hotmail.com', 'rick@aol.com', 'doug@yahoo.com']}
response = RestClient.post(url, args.to_json, :content_type => "application/json;charset=utf-8")
puts response	
						
import requests
url = "https://example.com/API/Rest/Segments/CreateFixed"
args = {'accountName':'acme','login':'ApiUser','password':'YOUR_PASSWORD','name':'Test1','description':'some description','emailAddresses':['joe@example.com', 'abc@aol.com', 'sam@hotmail.com', 'rick@aol.com', 'doug@yahoo.com']}
headers = {'Content-Type': 'application/json'}
resp = requests.post(url, json=args, headers=headers)
if resp.status_code == 200:
	print(resp.text)

curl --request POST --header "Content-Type: application/json" --data '{"accountName":"acme","login":"ApiUser", "password":"YOUR_PASSWORD", "name":"Test1", "description":"some description", "emailAddresses":["joe@example.com", "abc@aol.com", "sam@hotmail.com", "rick@aol.com", "doug@yahoo.com"]}' "https://example.com/API/Rest/Segments/CreateFixed"