Colony

TRITECH MEDIA

COLONY REST API

GET POST OPTIONS

Description:

Lists available contact lists for a company

Model:

{
    "saved_query": "int", 
    "title": "string", 
    "date_updated": "datetime", 
    "date_created": "datetime", 
    "company": "int", 
    "id": "int"
}

Test:

You can test this API using the link below.

/contact/contactlists/

GET PUT PATCH DELETE OPTIONS

Description:

Allows the retrieval and updating of company details

Model:

{
    "saved_query": "int", 
    "title": "string", 
    "date_updated": "datetime", 
    "date_created": "datetime", 
    "company": "int", 
    "id": "int"
}
GET POST OPTIONS

Description:

Listing and Creation of batch contacts for a contact list.

Model:

{}

Test:

You can test this API using the link below.

/contact/contactlists/contact/

GET POST OPTIONS

Description:

Imports contact lists from uploaded CSV files

File should be in the 'file' parameter

Model:

{}
GET POST OPTIONS

Description:

Imports contact lists from uploaded CSV files

File should be in the 'file' parameter

Model:

{}
GET OPTIONS

Description:

Refreshes and populates contact lists containing saved queries

Model:

{}
DELETE OPTIONS

Description:

Provides the ability to delete contact lists

Model:

{}
POST OPTIONS

Description:

Provides the ability to launch a task to save contacts to a contact list

Model:

{}

Test:

You can test this API using the link below.

/contact/contactlists/generatecontactlist/

GET PUT PATCH DELETE OPTIONS

Description:

Retrieving updating and destroying of individual contacts for a contact list.

Model:

{}
GET POST OPTIONS

Description:

Model:

{
    "status": "int", 
    "updated_by": "int", 
    "title": "string", 
    "date_updated": "datetime", 
    "marketing": "boolean", 
    "company": "int", 
    "optout": "boolean", 
    "dispatch": "int", 
    "total_credits": "int", 
    "total_contacts": "int", 
    "send_date": "datetime", 
    "created_by": "int", 
    "error": "string", 
    "date_created": "datetime", 
    "linked_campaign": "int", 
    "id": "int", 
    "approved_by": "int"
}

Test:

You can test this API using the link below.

/contact/deployments/

POST OPTIONS

Description:

Imports deployments from uploaded CSV files

File should be in the 'file' parameter

Model:

{
    "status": "int", 
    "updated_by": "int", 
    "title": "string", 
    "date_updated": "datetime", 
    "marketing": "boolean", 
    "company": "int", 
    "optout": "boolean", 
    "dispatch": "int", 
    "total_credits": "int", 
    "total_contacts": "int", 
    "send_date": "datetime", 
    "created_by": "int", 
    "error": "string", 
    "date_created": "datetime", 
    "linked_campaign": "int", 
    "id": "int", 
    "approved_by": "int"
}

Test:

You can test this API using the link below.

/contact/deployments/upload/

POST OPTIONS

Description:

Imports deployments from uploaded CSV files

File should be in the 'file' parameter

Model:

{
    "status": "int", 
    "updated_by": "int", 
    "title": "string", 
    "date_updated": "datetime", 
    "marketing": "boolean", 
    "company": "int", 
    "optout": "boolean", 
    "dispatch": "int", 
    "total_credits": "int", 
    "total_contacts": "int", 
    "send_date": "datetime", 
    "created_by": "int", 
    "error": "string", 
    "date_created": "datetime", 
    "linked_campaign": "int", 
    "id": "int", 
    "approved_by": "int"
}

Test:

You can test this API using the link below.

/contact/deployments/uploadbulk/

GET OPTIONS

Description:

Allows for a deployment report to be generated and placed inside the company/user filebox

Model:

{}
GET OPTIONS

Description:

Imports deployments from uploaded CSV files

File should be in the 'file' parameter

Model:

{
    "status": "int", 
    "updated_by": "int", 
    "title": "string", 
    "date_updated": "datetime", 
    "marketing": "boolean", 
    "company": "int", 
    "optout": "boolean", 
    "dispatch": "int", 
    "total_credits": "int", 
    "total_contacts": "int", 
    "send_date": "datetime", 
    "created_by": "int", 
    "error": "string", 
    "date_created": "datetime", 
    "linked_campaign": "int", 
    "id": "int", 
    "approved_by": "int"
}
GET OPTIONS

Description:

Model:

{}

Test:

You can test this API using the link below.

/contact/deployments/messages/overtime/

GET OPTIONS

Description:

Provides stats for messages coming into a deployments by hour.

Model:

{
    "email_sent_count": "int", 
    "deployment": "int", 
    "sms_optout_count": "int", 
    "email_unsent_count": "int", 
    "email_optout_count": "int", 
    "period_type": "int", 
    "period_end": "datetime", 
    "period_start": "datetime", 
    "total": "int", 
    "id": "int", 
    "sms_sent_count": "int", 
    "sms_unsent_count": "int"
}

Test:

You can test this API using the link below.

/contact/deploymentstats/

GET OPTIONS

Description:

Provides stats for messages coming into a deployments by hour.

Model:

{
    "email_sent_count": "int", 
    "deployment": "int", 
    "sms_optout_count": "int", 
    "email_unsent_count": "int", 
    "email_optout_count": "int", 
    "period_type": "int", 
    "period_end": "datetime", 
    "period_start": "datetime", 
    "total": "int", 
    "id": "int", 
    "sms_sent_count": "int", 
    "sms_unsent_count": "int"
}

Test:

You can test this API using the link below.

/contact/deploymentstats/hour/

GET OPTIONS

Description:

Provides stats for messages coming into a deployments by hour.

Model:

{
    "email_sent_count": "int", 
    "deployment": "int", 
    "sms_optout_count": "int", 
    "email_unsent_count": "int", 
    "email_optout_count": "int", 
    "period_type": "int", 
    "period_end": "datetime", 
    "period_start": "datetime", 
    "total": "int", 
    "id": "int", 
    "sms_sent_count": "int", 
    "sms_unsent_count": "int"
}
GET OPTIONS

Description:

Provides stats for messages coming into a deployments by day.

Model:

{
    "email_sent_count": "int", 
    "deployment": "int", 
    "sms_optout_count": "int", 
    "email_unsent_count": "int", 
    "email_optout_count": "int", 
    "period_type": "int", 
    "period_end": "datetime", 
    "period_start": "datetime", 
    "total": "int", 
    "id": "int", 
    "sms_sent_count": "int", 
    "sms_unsent_count": "int"
}

Test:

You can test this API using the link below.

/contact/deploymentstats/day/

GET OPTIONS

Description:

Provides stats for messages coming into a deployments by day.

Model:

{
    "email_sent_count": "int", 
    "deployment": "int", 
    "sms_optout_count": "int", 
    "email_unsent_count": "int", 
    "email_optout_count": "int", 
    "period_type": "int", 
    "period_end": "datetime", 
    "period_start": "datetime", 
    "total": "int", 
    "id": "int", 
    "sms_sent_count": "int", 
    "sms_unsent_count": "int"
}
GET OPTIONS

Description:

Provides stats for messages coming into a deployments by month.

Model:

{
    "email_sent_count": "int", 
    "deployment": "int", 
    "sms_optout_count": "int", 
    "email_unsent_count": "int", 
    "email_optout_count": "int", 
    "period_type": "int", 
    "period_end": "datetime", 
    "period_start": "datetime", 
    "total": "int", 
    "id": "int", 
    "sms_sent_count": "int", 
    "sms_unsent_count": "int"
}

Test:

You can test this API using the link below.

/contact/deploymentstats/month/

GET OPTIONS

Description:

Provides stats for messages coming into a deployments by month.

Model:

{
    "email_sent_count": "int", 
    "deployment": "int", 
    "sms_optout_count": "int", 
    "email_unsent_count": "int", 
    "email_optout_count": "int", 
    "period_type": "int", 
    "period_end": "datetime", 
    "period_start": "datetime", 
    "total": "int", 
    "id": "int", 
    "sms_sent_count": "int", 
    "sms_unsent_count": "int"
}
GET OPTIONS

Description:

Provides stats for messages coming into a deployments by year.

Model:

{
    "email_sent_count": "int", 
    "deployment": "int", 
    "sms_optout_count": "int", 
    "email_unsent_count": "int", 
    "email_optout_count": "int", 
    "period_type": "int", 
    "period_end": "datetime", 
    "period_start": "datetime", 
    "total": "int", 
    "id": "int", 
    "sms_sent_count": "int", 
    "sms_unsent_count": "int"
}

Test:

You can test this API using the link below.

/contact/deploymentstats/year/

GET OPTIONS

Description:

Provides stats for messages coming into a deployments by hour.

Model:

{
    "email_sent_count": "int", 
    "deployment": "int", 
    "sms_optout_count": "int", 
    "email_unsent_count": "int", 
    "email_optout_count": "int", 
    "period_type": "int", 
    "period_end": "datetime", 
    "period_start": "datetime", 
    "total": "int", 
    "id": "int", 
    "sms_sent_count": "int", 
    "sms_unsent_count": "int"
}
POST OPTIONS

Description:

You can send out individual messages sending in the below parameters.

Required Parameters:
param message:The actual text message that will be sent out. The message will be split into 160 character chunks with each chunk costing 1 credit.
param destination:
 The mobile number in international format that you want to send the message to. The format of the destination should look like 27815854565.
Optional Parameters:
param campaign_pk:
 The primary key of a campaign that you would like to link the sent message to for tracking purposes.

Model:

{}

Test:

You can test this API using the link below.

/contact/dispatchers/send-message/

POST OPTIONS

Description:

You can send out bulk messages sending in the below parameters.

Entry should look like this for bulk Messages:

[{"destination":"27815854565", "message":"Hi Colony"}, {"destination":"27815854565", "message":"Morning Colony"}, {"destination":"27815854565", "message":"Afternoon Colony"}]

Required Parameters:
param message:The actual text message that will be sent out. The message will be split into 160 character chunks with each chunk costing 1 credit.
param destination:
 The mobile number in international format that you want to send the message to. The format of the destination should look like 27815854565.
Optional Parameters:
param campaign_pk:
 The primary key of a campaign that you would like to link the sent message to for tracking purposes.

Model:

{}

Test:

You can test this API using the link below.

/contact/dispatchers/send-bulk-messages/

GET OPTIONS

Description:

Model:

{
    "originator": "string", 
    "date_opted_out": "datetime", 
    "reason": "string", 
    "date_overwritten": "datetime", 
    "overwritten_by": "int", 
    "company": "int", 
    "id": "int"
}

Test:

You can test this API using the link below.

/contact/optouts/display/

GET OPTIONS

Description:

Allows for opt outs to be filtered by originator as a query string

Model:

{
    "originator": "string", 
    "date_opted_out": "datetime", 
    "reason": "string", 
    "date_overwritten": "datetime", 
    "overwritten_by": "int", 
    "company": "int", 
    "id": "int"
}

Test:

You can test this API using the link below.

/contact/optouts/override/

POST OPTIONS

Description:

Allows for an optout to be overwritten.

Model:

{}
POST OPTIONS

Description:

Allows for an optout to be overwritten.

Model:

{}

Test:

You can test this API using the link below.

/contact/optouts/override/update/