Contacts
Phonebook API enables you to use our blacklisting feature and manage contacts and groups
Overview
Every contact in the Phonebook may belong to one or many Groups, which makes it easy to send targeted messages just by selecting the Groups you want.
You can think of Groups also as Labels that each Contacts can have.
When sending message to multiple groups, Messente only sends one message per Contact. This means you can send messages without having to worry about duplicate messages being sent.
Using the Phonebook API you can:
- Select Contacts and filter by Groups
- Retrieve Contact details
- Create a new Contact
- Update an existing Contacts
- Add or remove a Contact from a Group
- Delete a Contact
info
Bear in mind, that when deleting a Contact, it will be lost and cannot be restored.
Retrieve a contact
Endpoint
GET https://api.messente.com/v1/phonebook/contacts/{phone}
Parameters
phone=%2B37251000000
Successful Response
HTTP 200
{
"contact": {
"phoneNumber": "+37251000000",
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four",
"scheduledDeletionDate": "2020-08-31"
}
}
Using a library
- Python
- Node
- PHP
- Java
- Ruby
- .NET
- cURL
from messente_api import ContactsApi, ApiClient, Configuration
from messente_api.rest import ApiException
configuration = Configuration()
configuration.username = "YOUR_MESSENTE_API_USERNAME"
configuration.password = "YOUR_MESSENTE_API_PASSWORD"
api = ContactsApi(ApiClient(configuration))
try:
response = api.fetch_contact("+37251000000")
print(response)
except ApiException as e:
print("Exception when calling fetch_contact: %s\n" % e)
const MessenteApi = require("messente_api");
const defaultClient = MessenteApi.ApiClient.instance;
const basicAuth = defaultClient.authentications["basicAuth"];
basicAuth.username = "YOUR_MESSENTE_API_USERNAME";
basicAuth.password = "YOUR_MESSENTE_API_PASSWORD";
const api = new MessenteApi.ContactsApi();
api.fetchContact("+37251000000", (error, data, response) => {
if (error) {
console.error(error.response.body);
} else {
console.log("API called successfully. \n", response.body);
}
});
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Messente\Api\Configuration;
use GuzzleHttp\Client;
use Messente\Api\Api\ContactsApi;
$config = Configuration::getDefaultConfiguration();
$config->setUsername('YOUR_MESSENTE_API_USERNAME');
$config->setPassword('YOUR_MESSENTE_API_PASSWORD');
$api = new ContactsApi(new Client(), $config);
try {
$response = $api->fetchContact('+37251000000');
echo $response . PHP_EOL;
} catch (Exception $e) {
echo 'Exception when calling fetchContact: ', $e->getMessage(), PHP_EOL;
}
?>
import com.messente.ApiClient;
import com.messente.ApiException;
import com.messente.api.ContactEnvelope;
import com.messente.api.ContactsApi;
import com.messente.auth.HttpBasicAuth;
public class FetchContactExample {
public static void main(String[] args) {
ApiClient apiClient = new ApiClient();
HttpBasicAuth basicAuth = (HttpBasicAuth) apiClient.getAuthentication("basicAuth");
basicAuth.setUsername("YOUR_MESSENTE_API_USERNAME");
basicAuth.setPassword("YOUR_MESSENTE_API_PASSWORD");
ContactsApi api = new ContactsApi(apiClient);
try {
ContactEnvelope response = api.fetchContact("+37251000000");
System.out.println(response);
} catch (ApiException e) {
System.err.println("Exception when calling fetchContact");
e.printStackTrace();
}
}
}
require 'messente_api'
MessenteApi.configure do |config|
config.username = 'YOUR_MESSENTE_API_USERNAME'
config.password = 'YOUR_MESSENTE_API_PASSWORD'
end
api = MessenteApi::ContactsApi.new
begin
result = api.fetch_contact('+37251000000')
p result.contact
rescue MessenteApi::ApiError => e
p "Exception when calling fetch_contact: #{e.response_body}"
end
using System;
using com.Messente.Api.Api;
using com.Messente.Api.Client;
using com.Messente.Api.Model;
namespace Example
{
public class FetchContactExample
{
static void Main(string[] args)
{
Configuration.Default.Username = "YOUR_MESSENTE_API_USERNAME";
Configuration.Default.Password = "YOUR_MESSENTE_API_PASSWORD";
var api = new ContactsApi();
try
{
ContactEnvelope result = api.FetchContact("+37251000000");
Console.WriteLine(result.ToJson());
}
catch (Exception e)
{
Console.WriteLine("Exception when calling FetchContact: " + e.Message);
}
}
}
}
curl https://api.messente.com/v1/phonebook/contacts/+37251000000 \
-u YOUR_MESSENTE_API_USERNAME:YOUR_MESSENTE_API_PASSWORD
Delete a contact
Using a library
- Python
- Node
- PHP
- Java
- Ruby
- .NET
- cURL
from messente_api import ContactsApi, ApiClient, Configuration
from messente_api.rest import ApiException
configuration = Configuration()
configuration.username = "YOUR_MESSENTE_API_USERNAME"
configuration.password = "YOUR_MESSENTE_API_PASSWORD"
api = ContactsApi(ApiClient(configuration))
try:
api.delete_contact("+37251000000")
print("API called successfully.")
except ApiException as e:
print("Exception when calling delete_contact: %s\n" % e)
const MessenteApi = require("messente_api");
const defaultClient = MessenteApi.ApiClient.instance;
const basicAuth = defaultClient.authentications["basicAuth"];
basicAuth.username = "YOUR_MESSENTE_API_USERNAME";
basicAuth.password = "YOUR_MESSENTE_API_PASSWORD";
const api = new MessenteApi.ContactsApi();
api.deleteContact("+37251000000", (error, data, response) => {
if (error) {
console.error(error.response.body);
} else {
console.log("API called successfully.");
}
});
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Messente\Api\Configuration;
use GuzzleHttp\Client;
use Messente\Api\Api\ContactsApi;
$config = Configuration::getDefaultConfiguration();
$config->setUsername('YOUR_MESSENTE_API_USERNAME');
$config->setPassword('YOUR_MESSENTE_API_PASSWORD');
$api = new ContactsApi(new Client(), $config);
try {
$api->deleteContact('+37251000000');
echo 'API called successfully.' . PHP_EOL;
} catch (Exception $e) {
echo 'Exception when calling deleteContact: ', $e->getMessage(), PHP_EOL;
}
?>
import com.messente.ApiClient;
import com.messente.ApiException;
import com.messente.api.ContactsApi;
import com.messente.auth.HttpBasicAuth;
public class DeleteContactExample {
public static void main(String[] args) {
ApiClient apiClient = new ApiClient();
HttpBasicAuth basicAuth = (HttpBasicAuth) apiClient.getAuthentication("basicAuth");
basicAuth.setUsername("YOUR_MESSENTE_API_USERNAME");
basicAuth.setPassword("YOUR_MESSENTE_API_PASSWORD");
ContactsApi api = new ContactsApi(apiClient);
try {
api.deleteContact("+37251000000");
System.out.println("API called successfully.");
} catch (ApiException e) {
System.err.println("Exception when calling deleteContact");
e.printStackTrace();
}
}
}
require 'messente_api'
MessenteApi.configure do |config|
config.username = 'YOUR_MESSENTE_API_USERNAME'
config.password = 'YOUR_MESSENTE_API_PASSWORD'
end
api = MessenteApi::ContactsApi.new
begin
api.delete_contact('+37251000000')
p 'API called successfully.'
rescue MessenteApi::ApiError => e
p "Exception when calling delete_contact: #{e.response_body}"
end
using System;
using com.Messente.Api.Api;
using com.Messente.Api.Client;
namespace Example
{
public class DeleteContactExample
{
static void Main(string[] args)
{
Configuration.Default.Username = "YOUR_MESSENTE_API_USERNAME";
Configuration.Default.Password = "YOUR_MESSENTE_API_PASSWORD";
var api = new ContactsApi();
try
{
api.DeleteContact("+37251000000");
Console.WriteLine("API called successfully.");
}
catch (Exception e)
{
Console.WriteLine("Exception when calling DeleteContact: " + e.Message);
}
}
}
}
curl -X DELETE \
'https://api.messente.com/v1/phonebook/contacts/+37251000000' \
-u YOUR_MESSENTE_API_USERNAME:YOUR_MESSENTE_API_PASSWORD
Update a contact
Endpoint
PATCH https://api.messente.com/v1/phonebook/contacts/{phone}
Parameters
phone=%2B37251000000
Request Body
{
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four"
}
Successful Response
HTTP 200
{
"contact": {
"phoneNumber": "+37251000000",
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four",
"scheduledDeletionDate": "2020-08-31"
}
}
Using a library
- Python
- Node
- PHP
- Java
- Ruby
- .NET
- cURL
from messente_api import ContactsApi, ApiClient, Configuration
from messente_api.rest import ApiException
configuration = Configuration()
configuration.username = "YOUR_MESSENTE_API_USERNAME"
configuration.password = "YOUR_MESSENTE_API_PASSWORD"
api = ContactsApi(ApiClient(configuration))
try:
response = api.update_contact(
"+37251000000",
{
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four",
},
)
print(response)
except ApiException as e:
print("Exception when calling update_contact: %s\n" % e)
const MessenteApi = require("messente_api");
const defaultClient = MessenteApi.ApiClient.instance;
const basicAuth = defaultClient.authentications["basicAuth"];
basicAuth.username = "YOUR_MESSENTE_API_USERNAME";
basicAuth.password = "YOUR_MESSENTE_API_PASSWORD";
const api = new MessenteApi.ContactsApi();
api.updateContact(
"+37251000000",
{
email: "anyone@messente.com",
firstName: "Any",
lastName: "One",
company: "Messente",
title: "Sir",
custom: "Any custom",
custom2: "Any custom two",
custom3: "Any custom three",
custom4: "Any custom four",
},
(error, data, response) => {
if (error) {
console.error(error.response.body);
} else {
console.log("API called successfully. \n", response.body);
}
}
);
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Messente\Api\Configuration;
use GuzzleHttp\Client;
use Messente\Api\Api\ContactsApi;
$config = Configuration::getDefaultConfiguration();
$config->setUsername('YOUR_MESSENTE_API_USERNAME');
$config->setPassword('YOUR_MESSENTE_API_PASSWORD');
$api = new ContactsApi(new Client(), $config);
try {
$response = $api->updateContact('+37251000000', [
'email' => 'anyone@messente.com',
'firstName' => 'Any',
'lastName' => 'One',
'company' => 'Messente',
'title' => 'Sir',
'custom' => 'Any custom',
'custom2' => 'Any custom two',
'custom3' => 'Any custom three',
'custom4' => 'Any custom four'
]);
echo $response . PHP_EOL;
} catch (Exception $e) {
echo 'Exception when calling updateContact: ', $e->getMessage(), PHP_EOL;
}
?>
import com.messente.ApiClient;
import com.messente.ApiException;
import com.messente.api.ContactEnvelope;
import com.messente.api.ContactUpdateFields;
import com.messente.api.ContactsApi;
import com.messente.auth.HttpBasicAuth;
public class UpdateContactExample {
public static void main(String[] args) {
ApiClient apiClient = new ApiClient();
HttpBasicAuth basicAuth = (HttpBasicAuth) apiClient.getAuthentication("basicAuth");
basicAuth.setUsername("YOUR_MESSENTE_API_USERNAME");
basicAuth.setPassword("YOUR_MESSENTE_API_PASSWORD");
ContactsApi api = new ContactsApi(apiClient);
try {
ContactUpdateFields fields = new ContactUpdateFields();
fields.email("anyone@messente.com");
fields.firstName("Any");
fields.lastName("One");
fields.company("Messente");
fields.title("Sir");
fields.custom("Any custom");
fields.custom2("Any custom two");
fields.custom3("Any custom three");
fields.custom4("Any custom four");
ContactEnvelope response = api.updateContact("+37251000000", fields);
System.out.println(response);
} catch (ApiException e) {
System.err.println("Exception when calling updateContact");
e.printStackTrace();
}
}
}
require 'messente_api'
MessenteApi.configure do |config|
config.username = 'YOUR_MESSENTE_API_USERNAME'
config.password = 'YOUR_MESSENTE_API_PASSWORD'
end
api = MessenteApi::ContactsApi.new
begin
result = api.update_contact(
'+37251000000',
'email': 'anyone@messente.com',
'firstName': 'Any',
'lastName': 'One',
'company': 'Messente',
'title': 'Sir',
'custom': 'Any custom',
'custom2': 'Any custom two',
'custom3': 'Any custom three',
'custom4': 'Any custom four'
)
p result.contact
rescue MessenteApi::ApiError => e
p "Exception when calling update_contact: #{e.response_body}"
end
using System;
using com.Messente.Api.Api;
using com.Messente.Api.Client;
using com.Messente.Api.Model;
namespace Example
{
public class UpdateContactExample
{
static void Main(string[] args)
{
Configuration.Default.Username = "YOUR_MESSENTE_API_USERNAME";
Configuration.Default.Password = "YOUR_MESSENTE_API_PASSWORD";
var api = new ContactsApi();
try
{
var fields = new ContactUpdateFields(
email: "anyone@messente.com",
firstName: "Any",
lastName: "One",
company: "Messente",
title: "Sir",
custom: "Any custom",
custom2: "Any custom two",
custom3: "Any custom three",
custom4: "Any custom four"
);
ContactEnvelope result = api.UpdateContact("+37251000000", fields);
Console.WriteLine(result.ToJson());
}
catch (Exception e)
{
Console.WriteLine("Exception when calling UpdateContact: " + e.Message);
}
}
}
}
curl -X PATCH \
'https://api.messente.com/v1/phonebook/contacts/+37251000000' \
-u YOUR_MESSENTE_API_USERNAME:YOUR_MESSENTE_API_PASSWORD \
-H 'Content-Type: application/json' \
-d '{
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four"
}'
List groups of a contact
Using a library
- Python
- Node
- PHP
- Java
- Ruby
- .NET
- cURL
from messente_api import ContactsApi, ApiClient, Configuration
from messente_api.rest import ApiException
configuration = Configuration()
configuration.username = "YOUR_MESSENTE_API_USERNAME"
configuration.password = "YOUR_MESSENTE_API_PASSWORD"
api = ContactsApi(ApiClient(configuration))
try:
response = api.fetch_contact_groups("+37251000000")
print(response)
except ApiException as e:
print("Exception when calling fetch_contact_groups: %s\n" % e)
const MessenteApi = require("messente_api");
const defaultClient = MessenteApi.ApiClient.instance;
const basicAuth = defaultClient.authentications["basicAuth"];
basicAuth.username = "YOUR_MESSENTE_API_USERNAME";
basicAuth.password = "YOUR_MESSENTE_API_PASSWORD";
const api = new MessenteApi.ContactsApi();
api.fetchContactGroups("+37251000000", (error, data, response) => {
if (error) {
console.error(error.response.body);
} else {
console.log("API called successfully. \n", response.body);
}
});
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Messente\Api\Configuration;
use GuzzleHttp\Client;
use Messente\Api\Api\ContactsApi;
$config = Configuration::getDefaultConfiguration();
$config->setUsername('YOUR_MESSENTE_API_USERNAME');
$config->setPassword('YOUR_MESSENTE_API_PASSWORD');
$api = new ContactsApi(new Client(), $config);
try {
$response = $api->fetchContactGroups('+37251000000');
echo $response . PHP_EOL;
} catch (Exception $e) {
echo 'Exception when calling fetchContactGroups: ', $e->getMessage(), PHP_EOL;
}
?>
import com.messente.ApiClient;
import com.messente.ApiException;
import com.messente.api.ContactsApi;
import com.messente.api.GroupListEnvelope;
import com.messente.auth.HttpBasicAuth;
public class FetchContactGroupsExample {
public static void main(String[] args) {
ApiClient apiClient = new ApiClient();
HttpBasicAuth basicAuth = (HttpBasicAuth) apiClient.getAuthentication("basicAuth");
basicAuth.setUsername("YOUR_MESSENTE_API_USERNAME");
basicAuth.setPassword("YOUR_MESSENTE_API_PASSWORD");
ContactsApi api = new ContactsApi(apiClient);
try {
GroupListEnvelope response = api.fetchContactGroups("+37251000000");
System.out.println(response);
} catch (ApiException e) {
System.err.println("Exception when calling fetchContactGroups");
e.printStackTrace();
}
}
}
require 'messente_api'
MessenteApi.configure do |config|
config.username = 'YOUR_MESSENTE_API_USERNAME'
config.password = 'YOUR_MESSENTE_API_PASSWORD'
end
api = MessenteApi::ContactsApi.new
begin
result = api.fetch_contact_groups('+37251000000')
p result.groups
rescue MessenteApi::ApiError => e
p "Exception when calling fetch_contact_groups: #{e.response_body}"
end
using System;
using com.Messente.Api.Api;
using com.Messente.Api.Client;
using com.Messente.Api.Model;
namespace Example
{
public class FetchContactGroupsExample
{
static void Main(string[] args)
{
Configuration.Default.Username = "YOUR_MESSENTE_API_USERNAME";
Configuration.Default.Password = "YOUR_MESSENTE_API_PASSWORD";
var api = new ContactsApi();
try
{
GroupListEnvelope result = api.FetchContactGroups("+37251000000");
Console.WriteLine(result.ToJson());
}
catch (Exception e)
{
Console.WriteLine("Exception when calling FetchContactGroups: " + e.Message);
}
}
}
}
curl -X GET \
'https://api.messente.com/v1/phonebook/contacts/+37251000000/groups' \
-u YOUR_MESSENTE_API_USERNAME:YOUR_MESSENTE_API_PASSWORD
List all contacts
Endpoint
GET https://api.messente.com/v1/phonebook/contacts
Parameters
groupIds=5792a02a-e5c2-422b-a0a0-0ae65d814663&groupIds=4792a02a-e5c2-422b-a0a0-0ae65d814662
Successful Response
HTTP 200
{
"contacts": [
{
"phoneNumber": "+37251000000",
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four",
"scheduledDeletionDate": "2020-08-31"
}
]
}
Using a library
- Python
- Node
- PHP
- Java
- Ruby
- .NET
- cURL
from messente_api import ContactsApi, ApiClient, Configuration
from messente_api.rest import ApiException
configuration = Configuration()
configuration.username = "YOUR_MESSENTE_API_USERNAME"
configuration.password = "YOUR_MESSENTE_API_PASSWORD"
api = ContactsApi(ApiClient(configuration))
try:
response = api.fetch_contacts(
group_ids=[
"5792a02a-e5c2-422b-a0a0-0ae65d814663",
"4792a02a-e5c2-422b-a0a0-0ae65d814662",
]
)
print(response)
except ApiException as e:
print("Exception when calling fetch_contacts: %s\n" % e)
const MessenteApi = require("messente_api");
const defaultClient = MessenteApi.ApiClient.instance;
const basicAuth = defaultClient.authentications["basicAuth"];
basicAuth.username = "YOUR_MESSENTE_API_USERNAME";
basicAuth.password = "YOUR_MESSENTE_API_PASSWORD";
const api = new MessenteApi.ContactsApi();
api.fetchContacts(
{
groupIds: [
"5792a02a-e5c2-422b-a0a0-0ae65d814663",
"4792a02a-e5c2-422b-a0a0-0ae65d814662",
],
},
(error, data, response) => {
if (error) {
console.error(error.response.body);
} else {
console.log("API called successfully. \n", response.body);
}
}
);
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Messente\Api\Configuration;
use GuzzleHttp\Client;
use Messente\Api\Api\ContactsApi;
$config = Configuration::getDefaultConfiguration();
$config->setUsername('YOUR_MESSENTE_API_USERNAME');
$config->setPassword('YOUR_MESSENTE_API_PASSWORD');
$api = new ContactsApi(new Client(), $config);
try {
$groupIds = array(
'5792a02a-e5c2-422b-a0a0-0ae65d814663',
'4792a02a-e5c2-422b-a0a0-0ae65d814662'
);
$response = $api->fetchContacts($groupIds);
echo $response . PHP_EOL;
} catch (Exception $e) {
echo 'Exception when calling fetchContacts: ', $e->getMessage(), PHP_EOL;
}
?>
import java.util.ArrayList;
import com.messente.ApiClient;
import com.messente.ApiException;
import com.messente.api.ContactListEnvelope;
import com.messente.api.ContactsApi;
import com.messente.auth.HttpBasicAuth;
public class FetchContactsExample {
public static void main(String[] args) {
ApiClient apiClient = new ApiClient();
HttpBasicAuth basicAuth = (HttpBasicAuth) apiClient.getAuthentication("basicAuth");
basicAuth.setUsername("YOUR_MESSENTE_API_USERNAME");
basicAuth.setPassword("YOUR_MESSENTE_API_PASSWORD");
ContactsApi api = new ContactsApi(apiClient);
try {
ArrayList<String> groupIds = new ArrayList<String>();
groupIds.add("5792a02a-e5c2-422b-a0a0-0ae65d814663");
groupIds.add("4792a02a-e5c2-422b-a0a0-0ae65d814662");
ContactListEnvelope response = api.fetchContacts(groupIds);
System.out.println(response);
} catch (ApiException e) {
System.err.println("Exception when calling fetchContacts");
e.printStackTrace();
}
}
}
require 'messente_api'
MessenteApi.configure do |config|
config.username = 'YOUR_MESSENTE_API_USERNAME'
config.password = 'YOUR_MESSENTE_API_PASSWORD'
config.params_encoding = :multi
end
api = MessenteApi::ContactsApi.new
begin
result = api.fetch_contacts(
group_ids: [
'5792a02a-e5c2-422b-a0a0-0ae65d814663',
'4792a02a-e5c2-422b-a0a0-0ae65d814662'
]
)
p result.contacts
rescue MessenteApi::ApiError => e
p "Exception when calling fetch_contacts: #{e.response_body}"
end
using System;
using System.Collections.Generic;
using com.Messente.Api.Api;
using com.Messente.Api.Client;
using com.Messente.Api.Model;
namespace Example
{
public class FetchContactsExample
{
static void Main(string[] args)
{
Configuration.Default.Username = "YOUR_MESSENTE_API_USERNAME";
Configuration.Default.Password = "YOUR_MESSENTE_API_PASSWORD";
var api = new ContactsApi();
try
{
var groupIds = new List<string>();
groupIds.Add("5792a02a-e5c2-422b-a0a0-0ae65d814663");
groupIds.Add("4792a02a-e5c2-422b-a0a0-0ae65d814662");
ContactListEnvelope result = api.FetchContacts(groupIds);
Console.WriteLine(result.ToJson());
}
catch (Exception e)
{
Console.WriteLine("Exception when calling FetchContacts: " + e.Message);
}
}
}
}
curl -X GET \
'https://api.messente.com/v1/phonebook/contacts?groupIds=b94a9361-b924-4f47-842e-d24fa47dafcb&groupIds=5792a02a-e5c2-422b-a0a0-0ae65d814663' \
-u YOUR_MESSENTE_API_USERNAME:YOUR_MESSENTE_API_PASSWORD
Create a new contact
Endpoint
POST https://api.messente.com/v1/phonebook/contacts
Request Body
{
"phoneNumber": "+37251000000",
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four"
}
Successful Response
HTTP 201
{
"contact": {
"phoneNumber": "+37251000000",
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four",
"scheduledDeletionDate": "2020-08-31"
}
}
Using a library
- Python
- Node
- PHP
- Java
- Ruby
- .NET
- cURL
from messente_api import ContactsApi, ApiClient, Configuration
from messente_api.rest import ApiException
configuration = Configuration()
configuration.username = "YOUR_MESSENTE_API_USERNAME"
configuration.password = "YOUR_MESSENTE_API_PASSWORD"
api = ContactsApi(ApiClient(configuration))
try:
response = api.create_contact(
{
"phoneNumber": "+37251000000",
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four",
}
)
print(response)
except ApiException as e:
print("Exception when calling create_contact: %s\n" % e)
const MessenteApi = require("messente_api");
const defaultClient = MessenteApi.ApiClient.instance;
const basicAuth = defaultClient.authentications["basicAuth"];
basicAuth.username = "YOUR_MESSENTE_API_USERNAME";
basicAuth.password = "YOUR_MESSENTE_API_PASSWORD";
const api = new MessenteApi.ContactsApi();
api.createContact(
{
phoneNumber: "+37251000000",
email: "anyone@messente.com",
firstName: "Any",
lastName: "One",
company: "Messente",
title: "Sir",
custom: "Any custom",
custom2: "Any custom two",
custom3: "Any custom three",
custom4: "Any custom four",
},
(error, data, response) => {
if (error) {
console.error(error.response.body);
} else {
console.log("API called successfully. \n", response.body);
}
}
);
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Messente\Api\Configuration;
use GuzzleHttp\Client;
use Messente\Api\Api\ContactsApi;
$config = Configuration::getDefaultConfiguration();
$config->setUsername('YOUR_MESSENTE_API_USERNAME');
$config->setPassword('YOUR_MESSENTE_API_PASSWORD');
$api = new ContactsApi(new Client(), $config);
try {
$response = $api->createContact([
'phoneNumber' => '+37251000000',
'email' => 'anyone@messente.com',
'firstName' => 'Any',
'lastName' => 'One',
'company' => 'Messente',
'title' => 'Sir',
'custom' => 'Any custom',
'custom2' => 'Any custom two',
'custom3' => 'Any custom three',
'custom4' => 'Any custom four'
]);
echo $response . PHP_EOL;
} catch (Exception $e) {
echo 'Exception when calling createContact: ', $e->getMessage(), PHP_EOL;
}
?>
import com.messente.ApiClient;
import com.messente.ApiException;
import com.messente.api.ContactEnvelope;
import com.messente.api.ContactFields;
import com.messente.api.ContactsApi;
import com.messente.auth.HttpBasicAuth;
public class CreateContactExample {
public static void main(String[] args) {
ApiClient apiClient = new ApiClient();
HttpBasicAuth basicAuth = (HttpBasicAuth) apiClient.getAuthentication("basicAuth");
basicAuth.setUsername("YOUR_MESSENTE_API_USERNAME");
basicAuth.setPassword("YOUR_MESSENTE_API_PASSWORD");
ContactsApi api = new ContactsApi(apiClient);
try {
ContactFields fields = new ContactFields();
fields.phoneNumber("+37251000000");
fields.email("anyone@messente.com");
fields.firstName("Any");
fields.lastName("One");
fields.company("Messente");
fields.title("Sir");
fields.custom("Any custom");
fields.custom2("Any custom two");
fields.custom3("Any custom three");
fields.custom4("Any custom four");
ContactEnvelope response = api.createContact(fields);
System.out.println(response);
} catch (ApiException e) {
System.err.println("Exception when calling createContact");
e.printStackTrace();
}
}
}
require 'messente_api'
MessenteApi.configure do |config|
config.username = 'YOUR_MESSENTE_API_USERNAME'
config.password = 'YOUR_MESSENTE_API_PASSWORD'
end
api = MessenteApi::ContactsApi.new
begin
result = api.create_contact(
'phoneNumber': '+37251000000',
'email': 'anyone@messente.com',
'firstName': 'Any',
'lastName': 'One',
'company': 'Messente',
'title': 'Sir',
'custom': 'Any custom',
'custom2': 'Any custom two',
'custom3': 'Any custom three',
'custom4': 'Any custom four'
)
p result.contact
rescue MessenteApi::ApiError => e
p "Exception when calling create_contact: #{e.response_body}"
end
using System;
using com.Messente.Api.Api;
using com.Messente.Api.Client;
using com.Messente.Api.Model;
namespace Example
{
public class CreateContactExample
{
static void Main(string[] args)
{
Configuration.Default.Username = "YOUR_MESSENTE_API_USERNAME";
Configuration.Default.Password = "YOUR_MESSENTE_API_PASSWORD";
var api = new ContactsApi();
try
{
var fields = new ContactFields(
phoneNumber: "+37251000000",
email: "anyone@messente.com",
firstName: "Any",
lastName: "One",
company: "Messente",
title: "Sir",
custom: "Any custom",
custom2: "Any custom two",
custom3: "Any custom three",
custom4: "Any custom four"
);
ContactEnvelope result = api.CreateContact(fields);
Console.WriteLine(result.ToJson());
}
catch (Exception e)
{
Console.WriteLine("Exception when calling CreateContact: " + e.Message);
}
}
}
}
curl -X POST \
'https://api.messente.com/v1/phonebook/contacts' \
-u YOUR_MESSENTE_API_USERNAME:YOUR_MESSENTE_API_PASSWORD \
-H 'Content-Type: application/json' \
-d '{
"phoneNumber": "+37251000000",
"email": "anyone@messente.com",
"firstName": "Any",
"lastName": "One",
"company": "Messente",
"title": "Sir",
"custom": "Any custom",
"custom2": "Any custom two",
"custom3": "Any custom three",
"custom4": "Any custom four"
}'
Add a contact to a group
Using a library
- Python
- Node
- PHP
- Java
- Ruby
- .NET
- cURL
from messente_api import ContactsApi, ApiClient, Configuration
from messente_api.rest import ApiException
configuration = Configuration()
configuration.username = "YOUR_MESSENTE_API_USERNAME"
configuration.password = "YOUR_MESSENTE_API_PASSWORD"
api = ContactsApi(ApiClient(configuration))
try:
response = api.add_contact_to_group(
"5792a02a-e5c2-422b-a0a0-0ae65d814663", "+37251000000"
)
print(response)
except ApiException as e:
print("Exception when calling add_contact_to_group: %s\n" % e)
const MessenteApi = require("messente_api");
const defaultClient = MessenteApi.ApiClient.instance;
const basicAuth = defaultClient.authentications["basicAuth"];
basicAuth.username = "YOUR_MESSENTE_API_USERNAME";
basicAuth.password = "YOUR_MESSENTE_API_PASSWORD";
const api = new MessenteApi.ContactsApi();
api.addContactToGroup(
"5792a02a-e5c2-422b-a0a0-0ae65d814663",
"+37251000000",
(error, data, response) => {
if (error) {
console.error(error.response.body);
} else {
console.log("API called successfully. \n", response.body);
}
}
);
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Messente\Api\Configuration;
use GuzzleHttp\Client;
use Messente\Api\Api\ContactsApi;
$config = Configuration::getDefaultConfiguration();
$config->setUsername('YOUR_MESSENTE_API_USERNAME');
$config->setPassword('YOUR_MESSENTE_API_PASSWORD');
$api = new ContactsApi(new Client(), $config);
try {
$response = $api->addContactToGroup('5792a02a-e5c2-422b-a0a0-0ae65d814663', '+37251000000');
echo json_encode($response) . PHP_EOL;
} catch (Exception $e) {
echo 'Exception when calling addContactToGroup: ', $e->getMessage(), PHP_EOL;
}
?>
import com.messente.ApiClient;
import com.messente.ApiException;
import com.messente.api.ContactsApi;
import com.messente.api.EmptyObject;
import com.messente.auth.HttpBasicAuth;
public class AddContactToGroupExample {
public static void main(String[] args) {
ApiClient apiClient = new ApiClient();
HttpBasicAuth basicAuth = (HttpBasicAuth) apiClient.getAuthentication("basicAuth");
basicAuth.setUsername("YOUR_MESSENTE_API_USERNAME");
basicAuth.setPassword("YOUR_MESSENTE_API_PASSWORD");
ContactsApi api = new ContactsApi(apiClient);
try {
String groupId = "5792a02a-e5c2-422b-a0a0-0ae65d814663";
EmptyObject response = api.addContactToGroup(groupId, "+37251000000");
System.out.println(response);
} catch (ApiException e) {
System.err.println("Exception when calling addContactToGroup");
e.printStackTrace();
}
}
}
require 'messente_api'
MessenteApi.configure do |config|
config.username = 'YOUR_MESSENTE_API_USERNAME'
config.password = 'YOUR_MESSENTE_API_PASSWORD'
end
api = MessenteApi::ContactsApi.new
begin
result = api.add_contact_to_group(
'5792a02a-e5c2-422b-a0a0-0ae65d814663',
'+37251000000'
)
p result
rescue MessenteApi::ApiError => e
p "Exception when calling add_contact_to_group: #{e.response_body}"
end
using System;
using com.Messente.Api.Api;
using com.Messente.Api.Client;
using com.Messente.Api.Model;
namespace Example
{
public class AddContactToGroupExample
{
static void Main(string[] args)
{
Configuration.Default.Username = "YOUR_MESSENTE_API_USERNAME";
Configuration.Default.Password = "YOUR_MESSENTE_API_PASSWORD";
var api = new ContactsApi();
try
{
EmptyObject result = api.AddContactToGroup(
"5792a02a-e5c2-422b-a0a0-0ae65d814663",
"+37251000000"
);
Console.WriteLine(result.ToJson());
}
catch (Exception e)
{
Console.WriteLine("Exception when calling AddContactToGroup: " + e.Message);
}
}
}
}
curl -X POST \
'https://api.messente.com/v1/phonebook/groups/5792a02a-e5c2-422b-a0a0-0ae65d814663/contacts/+37251000000' \
-u YOUR_MESSENTE_API_USERNAME:YOUR_MESSENTE_API_PASSWORD
Remove a contact from a group
Using a library
- Python
- Node
- PHP
- Java
- Ruby
- .NET
- cURL
from messente_api import ContactsApi, ApiClient, Configuration
from messente_api.rest import ApiException
configuration = Configuration()
configuration.username = "YOUR_MESSENTE_API_USERNAME"
configuration.password = "YOUR_MESSENTE_API_PASSWORD"
api = ContactsApi(ApiClient(configuration))
try:
api.remove_contact_from_group(
"5792a02a-e5c2-422b-a0a0-0ae65d814663", "+37251000000"
)
print("API called successfully.")
except ApiException as e:
print("Exception when calling remove_contact_from_group: %s\n" % e)
const MessenteApi = require("messente_api");
const defaultClient = MessenteApi.ApiClient.instance;
const basicAuth = defaultClient.authentications["basicAuth"];
basicAuth.username = "YOUR_MESSENTE_API_USERNAME";
basicAuth.password = "YOUR_MESSENTE_API_PASSWORD";
const api = new MessenteApi.ContactsApi();
api.removeContactFromGroup(
"5792a02a-e5c2-422b-a0a0-0ae65d814663",
"+37251000000",
(error, data, response) => {
if (error) {
console.error(error.response.body);
} else {
console.log("API called successfully.");
}
}
);
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Messente\Api\Configuration;
use GuzzleHttp\Client;
use Messente\Api\Api\ContactsApi;
$config = Configuration::getDefaultConfiguration();
$config->setUsername('YOUR_MESSENTE_API_USERNAME');
$config->setPassword('YOUR_MESSENTE_API_PASSWORD');
$api = new ContactsApi(new Client(), $config);
try {
$api->removeContactFromGroup('5792a02a-e5c2-422b-a0a0-0ae65d814663', '+37251000000');
echo 'API called successfully.' . PHP_EOL;
} catch (Exception $e) {
echo 'Exception when calling removeContactFromGroup: ', $e->getMessage(), PHP_EOL;
}
?>
import com.messente.ApiClient;
import com.messente.ApiException;
import com.messente.api.ContactsApi;
import com.messente.auth.HttpBasicAuth;
public class RemoveContactFromGroupExample {
public static void main(String[] args) {
ApiClient apiClient = new ApiClient();
HttpBasicAuth basicAuth = (HttpBasicAuth) apiClient.getAuthentication("basicAuth");
basicAuth.setUsername("YOUR_MESSENTE_API_USERNAME");
basicAuth.setPassword("YOUR_MESSENTE_API_PASSWORD");
ContactsApi api = new ContactsApi(apiClient);
try {
String groupId = "5792a02a-e5c2-422b-a0a0-0ae65d814663";
api.removeContactFromGroup(groupId, "+37251000000");
System.out.println("API called successfully.");
} catch (ApiException e) {
System.err.println("Exception when calling removeContactFromGroup");
e.printStackTrace();
}
}
}
require 'messente_api'
MessenteApi.configure do |config|
config.username = 'YOUR_MESSENTE_API_USERNAME'
config.password = 'YOUR_MESSENTE_API_PASSWORD'
end
api = MessenteApi::ContactsApi.new
begin
api.remove_contact_from_group(
'5792a02a-e5c2-422b-a0a0-0ae65d814663',
'+37251000000'
)
p 'API called successfully.'
rescue MessenteApi::ApiError => e
p "Exception when calling remove_contact_from_group: #{e.response_body}"
end
using System;
using com.Messente.Api.Api;
using com.Messente.Api.Client;
namespace Example
{
public class RemoveContactFromGroupExample
{
static void Main(string[] args)
{
Configuration.Default.Username = "YOUR_MESSENTE_API_USERNAME";
Configuration.Default.Password = "YOUR_MESSENTE_API_PASSWORD";
var api = new ContactsApi();
try
{
api.RemoveContactFromGroup(
"5792a02a-e5c2-422b-a0a0-0ae65d814663",
"+37251000000"
);
Console.WriteLine("API called successfully.");
}
catch (Exception e)
{
Console.WriteLine("Exception when calling RemoveContactFromGroup: " + e.Message);
}
}
}
}
curl -X DELETE \
'https://api.messente.com/v1/phonebook/groups/5792a02a-e5c2-422b-a0a0-0ae65d814663/contacts/+37251000000' \
-u YOUR_MESSENTE_API_USERNAME:YOUR_MESSENTE_API_PASSWORD