Create Contact (API) | Dyn Help Center

Understanding How The API Works

Creating a contact in the API requires specific syntax depending on whether you are using REST or SOAP. Use this table to find the syntax for your command.

REST Syntax

Click to view all REST Resources
Contact/ POST — Creates a new contact. HTTP Action — POST URI — https://api.dynect.net/REST/Contact/<nickname>/
Arguments — Click for More Info string `address` — The contact’s street address. string `address_2` — The contact’s street address, line 2. string `city` — The contact’s city, part of the contact’s address. string `country` — The contact’s country, part of the contact’s address. string `email` — Required. The contact’s email address. string `fax` — The contact’s fax number. string `first_name` — Required. The contact’s first name. string `last_name` — Required. The contact’s last name. string `notify_email` — Email address at which the contact should receive notifications. string `organization` — Required. The contact’s organization. string `pager_email` — Email address at which the contact should receive messages destined for a pager. string `phone` — The contact’s phone number. A phone number can have the form: (0) (country-code) (local number) (ext extension) Only the country-code (1 – 3 digits) and the local number (1 – 7 digits) are required. The extension can be up to 4 digits. Any non-digits are ignored. string `post_code` — The contact’s postal (zip) code. string `state` — The contact’s state. string `website` — The URL of the contact’s website.
Response — Click for More Info string `address` — The contact’s street address. string `address_2` — The contact’s street address, line 2. string `city` — The contact’s city, part of the contact’s address. string `country` — The contact’s country, part of the contact’s address. string `email` — The contact’s email address. string `fax` — The contact’s fax number. string `first_name` — The contact’s first name. string `last_name` — The contact’s last name. string `notify_email` — Email address at which the contact should receive notifications. string `pager_email` — Email address at which the contact should receive messages destined for a pager. string `organization` — The contact’s organization. string `phone` — The contact’s phone number. A phone number can have the form: (0) (country-code) (local number) (ext extension) Only the country-code (1 – 3 digits) and the local number (1 – 7 digits) are required. The extension can be up to 4 digits. Any non-digits are ignored. string `post_code` — The contact’s postal (zip) code. string `state` — The contact’s state. string `website` — The URL of the contact’s website.

SOAP Syntax

Click to view all SOAP Commands
CreateContact — Creates a new contact.
Arguments — Click for More Info string `address` — The contact’s street address. string `address_2` — The contact’s street address, line 2. string `city` — The contact’s city, part of the contact’s address. string `country` — The contact’s country, part of the contact’s address. string `email` — Required. The contact’s email address. string `fax` — The contact’s fax number. string `first_name` — Required. The contact’s first name. string `last_name` — Required. The contact’s last name. string `new_nickname` — Specify an updated nickname for the contact, if desired. string `nickname` — Required. The current nickname for the contact. string `notify_email` — Email address at which the contact should receive notifications. string `pager_email` — Email address at which the contact should receive messages destined for a pager. string `organization` — Required. The contact’s organization. string `phone` — The contact’s phone number. A phone number can have the form: (0) (country-code) (local number) (ext extension) Only the country-code (1 – 3 digits) and the local number (1 – 7 digits) are required. The extension can be up to 4 digits. Any non-digits are ignored. string `post_code` — The contact’s postal (zip) code. string `state` — The contact’s state. string `token` — Required. The session identifier. string `website` — The URL of the contact’s website.
Response — Click for More Info hash data string `address` — The contact’s street address. string `address_2` — The contact’s street address, line 2. string `city` — The contact’s city, part of the contact’s address. string `country` — The contact’s country, part of the contact’s address. string `email` — The contact’s email address. string `fax` — The contact’s fax number. string `first_name` — The contact’s first name. string `last_name` — The contact’s last name. string `nickname` — The contact’s nickname. string `notify_email` — Email address at which the contact should receive notifications. string `pager_email` — Email address at which the contact should receive messages destined for a pager. string `organization` — The contact’s organization. string `phone` — The contact’s phone number. A phone number can have the form: (0) (country-code) (local number) (ext extension) Only the country-code (1 – 3 digits) and the local number (1 – 7 digits) are required. The extension can be up to 4 digits. Any non-digits are ignored. string `post_code` — The contact’s postal (zip) code. string `state` — The contact’s state. string `website` — The URL of the contact’s website.
Example Request — Click for More Info { 'nickname' => 'nick1', 'first_name' => 'fname1', 'last_name' => 'lname1,', 'email' => 'dyn@example.com', 'notify_email' => 'notify@example.com', 'pager_email' => 'page@example.com', 'address' => 'address1', 'address_2' => 'address2', 'city' => 'Manchester', 'state' => 'NH', 'post_code' => '03103', 'country' => 'US', 'phone' => '5554445555', 'fax' => '5557775555', 'website' => 'http://www.dyn.com', 'organization' => 'Dynamic Network Services, Inc.', 'token'=> 'zaq12wsxcDe34rf89gt56nh', }

<< DNS API Knowledge Base