gem 'sendgrid-api'

client = Sendgrid::API::Client.new('YOUR_USER', 'YOUR_KEY')

# create a profile object profile = Sendgrid::API::Entities::Profile.new(:first_name => 'Your first name', :last_name => 'Your last name') # get your profile profile = client.profile.get # modify your profile response = client.profile.set(profile)

# send basic text email response = client.mail.send(:to => 'johndoe@example.com', :from => 'brian@example.com', :subject => 'test using sendgrid api', :text => 'this is a test') # set SMTP API headers x_smtpapi = {:category => ['sendgrid-api test']} response = client.mail.send(:to => 'johndoe@example.com', :from => 'brian@example.com', :subject => 'test using sendgrid api', :text => 'this is a test', :x_smtpapi => x_smtpapi) # send files attached text = StringIO.new("This is my file content") file = Faraday::UploadIO.new(text, 'plain/text', 'sample.txt') response = client.mail.send(:to => 'johndoe@example.com', :from => 'brian@example.com', :subject => 'test using sendgrid api', :text => 'this is a test', :files => {'sample.txt' => file})

# get advanced statistics stats = client.stats.advanced(:start_date => '2013-01-01', :data_type => 'global')

# create a list object list = Sendgrid::API::Entities::List.new(:list => 'sendgrid-api list test') # add a new list response = client.lists.add(list) # edit an existing list response = client.lists.edit(list, 'new name') # get an existing list selected_list = client.lists.get(list) # get all lists all_lists = client.lists.get # delete a list response = client.lists.delete(list)

# create email objects email1 = Sendgrid::API::Entities::Email.new( :email => 'johndoe@example.com', :name => 'John Doe' ) email2 = Sendgrid::API::Entities::Email.new( :email => 'brian@example.com', :name => 'Brian' ) emails = [email1, email2] listname = 'sendgrid-api list test' # add emails to a list response = client.emails.add(listname, emails) # get all emails from a list all_emails = client.emails.get(listname) # get a specific email from a list selected_emails = client.emails.get(listname, email1) # delete an email from a list response = client.emails.delete(listname, email1)

# create sender address object address = Sendgrid::API::Entities::SenderAddress.new( :identity => 'sendgrid-api sender address test', :name => 'Sendgrid', :email => 'contact@sendgrid.com', :address => '1065 N Pacificenter Drive, Suite 425', :city => 'Anaheim', :state => 'CA', :zip => '92806', :country => 'US' ) # add a sender address response = client.sender_addresses.add(address) # edit a sender address address.city = 'Pleasanton' response = client.sender_addresses.edit(address, 'new identity') # get all sender addresses addresses = client.sender_addresses.list # get a sender address address = client.sender_addresses.get(address) # delete a sender address response = client.sender_addresses.delete(address)

# create marketing email object marketing_email = Sendgrid::API::Entities::MarketingEmail.new( :identity => 'sendgrid-api sender address test', :name => 'sendgrid-api marketing email test', :subject => 'My Marketing Email Test', :text => 'My text', :html => 'My HTML' ) # add a marketing email response = client.marketing_emails.add(marketing_email) # edit a marketing email marketing_email.html = 'My new HTML' response = client.marketing_emails.edit(marketing_email, 'new name') # get a marketing email newsletter = client.marketing_emails.get(marketing_email) # get all marketing emails newsletters = client.marketing_emails.list # delete a marketing email response = client.marketing_emails.delete(marketing_email)

# create category object category = Sendgrid::API::Entities::Category.new(:category => 'sendgrid-api test') marketing_email = 'sendgrid-api marketing email test' # add category response = client.categories.create(category) # add category to a marketing email response = client.categories.add(marketing_email, category) # remove category from a marketing email response = client.categories.remove(marketing_email, category) # get all categories categories = client.categories.list

listname = 'sendgrid-api list test' marketing_email = 'sendgrid-api marketing email test' # assign a recipient list to a marketing email response = client.recipients.add(listname, marketing_email) # get all lists assigned to a marketing email lists = client.recipients.get(marketing_email) # delete an assigned list from a marketing email response = client.recipients.delete(listname, marketing_email)

marketing_email = 'sendgrid-api marketing email test' # schedule a delivery time for a marketing email response = client.schedule.add(marketing_email) # imediately response = client.schedule.add(marketing_email, :after => 20) # 20 minutes from now response = client.schedule.add(marketing_email, :at => (Time.now + 10*60)) # 10 minutes from now # retrieve the scheduled delivery time for a marketing email schedule = client.schedule.get(marketing_email) # cancel a scheduled delivery time for a marketing email response = client.schedule.delete(marketing_email)